code: def render_aafigure(app, text, options):
      
  
      if aafigure is None:
          raise AafigError('aafigure module not installed')
  
      fname = get_basename(text, options)
      fname = '%s.%s' % (get_basename(text, options), options['format'])
      if app.builder.format == 'html':
          # HTML
          imgpath = relative_uri(app.builder.env.docname, '_images')
          relfn = posixpath.join(imgpath, fname)
          outfn = path.join(app.builder.outdir, '_images', fname)
      else:
          # Non-HTML
          if app.builder.format != 'latex':
              app.builder.warn('aafig: the builder format %s is not officially '
                      'supported, aafigure images could not work. Please report '
                      'problems and working builder to avoid this warning in '
                      'the future' % app.builder.format)
          relfn = fname
          outfn = path.join(app.builder.outdir, fname)
      metadata_fname = '%s.aafig' % outfn
  
      try:
          if path.isfile(outfn):
              extra = None
              if options['format'].lower() == 'svg':
                  f = None
                  try:
                      try:
                          f = open(metadata_fname, 'r')
                          extra = f.read()
                      except:
                          raise AafigError()
                  finally:
                      if f is not None:
                          f.close()
              return relfn, outfn, id, extra
      except AafigError:
          pass
  
      ensuredir(path.dirname(outfn))
  
      try:
          (visitor, output) = aafigure.render(text, outfn, options)
          output.close()
      except aafigure.UnsupportedFormatError as e:
          raise AafigError(str(e))
  
      extra = None
      if options['format'].lower() == 'svg':
          extra = visitor.get_size_attrs()
          f = open(metadata_fname, 'w')
          f.write(extra)
          f.close()
  
      return relfn, outfn, id, extra
docs: Render an ASCII art figure into the requested format output file.