index :: ui

ui.canvas

UI canvas for drawing

доступно с версии: 0.9.7

---

информация

Canvas drawing methods are close to Cairo graphic library Basic drawing workflow is: - create line, shape or text - stroke or fill it with color - update image

методы:

• abc draw music in ABC notation.
  параметры:

  • X left-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y top-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • MUSIC ABC notation
    тип: list
    обязательно: True
    

• arc draw arc
  параметры:

  • XC x-center coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • YC y-center coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • RC radius in pixel or percents of width
    тип: atom
    обязательно: True
    

  • A0 start angle in degrees or radians
    тип: atom
    обязательно: True
    

  • A1 end angle in degrees or radians
    тип: atom
    обязательно: True
    

• arrow creates arrow shape
  параметры:

  • X0 x-coord of start point in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y0 y-coord of start point in pixel or percents of height
    тип: atom
    обязательно: True
    

  • X1 x-coord of target point in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y1 y-coord of target point in pixel or percents of height
    тип: atom
    обязательно: True
    

  • [START] start shape
    тип: symbol
    

  • [END] end shape
    тип: symbol
    

• bg draws background
  параметры:
  • [COLOR] background color
    тип: list
    
• circle create circle shape
  параметры:

  • X x-coord
    тип: float
    обязательно: True
    

  • Y y-coord
    тип: float
    обязательно: True
    

  • RADIUS radius
    тип: float
    обязательно: True
    

• clear clear image
  

• close_path close path and its subpaths
  

• color set current color
  параметры:
  • DATA RGB, RGBA float list or hex or named color
    тип: list
    обязательно: True
    

• crestore restore previously saved context (pen type, width, color, matrix etc.)
  

• csave save current drawing context (pen type, width, color, matrix etc.)
  

• curve create bezier-curve shape
  параметры:

  • X0 x0-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y0 y0-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

  • X1 x1-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y1 y1-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

  • X2 x2-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y2 y2-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

  • X3 x3-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y4 y3-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

• dash set line dash pattern
  параметры:
  • PATTERN line dash pattern. If empty - reset to solid shape
    тип: list
    обязательно: True
    

• dump dumps all object info to Pd console window.
  

• ellipse draw ellipse
  параметры:

  • X left-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y top-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • WIDTH width
    тип: atom
    обязательно: True
    

  • HEIGHT height
    тип: atom
    обязательно: True
    

• fill fill shape with color
  параметры:

  • COLOR fill color
    тип: atom
    обязательно: True
    

  • [PRESERVE] preserve path after fill. You can call stroke method after that
    тип: atom
    

• font set current font
  параметры:

  • FONT font family
    тип: symbol
    обязательно: True
    

  • [SIZE] font size
    тип: float
    

• font_size set current font size
  параметры:
  • X font size
    тип: float
    обязательно: True
    
• icon draw named icon. Pass ? as single argument to dump all icons to Pd window.
  параметры:

  • X left-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y top-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • SIZE font size
    тип: float
    обязательно: True
    

  • ICON icon name. See https://fonts.google.com/icons for full list
    тип: symbol
    обязательно: True
    

• image draws image. Note: only PNG images are supported!
  параметры:

  • X left-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y top-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • PATH path to image file, full or relative to patch
    тип: symbol
    обязательно: True
    

  • [SCALE] image scale
    тип: float
    

• line create line shape
  параметры:

  • X0 x0-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y0 y0-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

  • X1 x1-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y1 y1-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

• line_cap set line cap
  параметры:
  • X line cap
    тип: symbol
    обязательно: True
    
• line_to add line segment to line shape
  параметры:

  • X x-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

• width set stroke width
  параметры:
  • WIDTH line width
    тип: float
    обязательно: True
    
• move_by move current drawing point by relative offset
  параметры:

  • X x relative offset in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y y relative offset in pixels or percents of height
    тип: atom
    обязательно: True
    

• move_to move current drawing point to absolute position
  параметры:

  • X x-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

• matrix set 2D transformation matrix
  параметры:

  • XX xx component of the affine transformation
    тип: atom
    обязательно: True
    

  • YX yx component of the affine transformation
    тип: atom
    обязательно: True
    

  • XY xy component of the affine transformation
    тип: atom
    обязательно: True
    

  • YY yy component of the affine transformation
    тип: atom
    обязательно: True
    

  • X0 x component of the affine transformation
    тип: atom
    обязательно: True
    

  • Y0 y component of the affine transformation
    тип: atom
    обязательно: True
    

• musicxml render MusicXML file
  параметры:

  • X x-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

  • FILE absolute or relative to patch filepath of MusicXML file
    тип: symbol
    обязательно: True
    

• new_path starts new path
  

• new_subpath starts new subpath, means no line connection between last point and new subpath shape
  

• polar creates polar grid
  параметры:

  • X x-coord of center in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord of center in pixel or percents of height
    тип: atom
    обязательно: True
    

  • [ADIV] number of divisions of 90 degree angle
    тип: int
    

  • [NC] number of circles
    тип: int
    

  • [CDIST] circle distance
    тип: int
    

• polygon create polygon shape
  параметры:

  • X0 x0-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y0 y0-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • X… x…-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y… y…-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • XN xn-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • YN yn-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

• pos set UI element position
  параметры:

  • X top left x-coord
    тип: float
    обязательно: True
    

  • Y top right y-coord
    тип: float
    обязательно: True
    

• qrcode create QR-code shape.
  параметры:

  • X left-coord in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y top-coord in pixel or percents of height
    тип: atom
    обязательно: True
    

  • PIXEL pixel size
    тип: int
    обязательно: True
    

  • TEXT message
    тип: symbol
    обязательно: True
    

• rect create rectangle shape
  параметры:

  • X x-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

  • W width in pixels or percents of width
    тип: atom
    обязательно: True
    

  • H height in pixels or percents of height
    тип: atom
    обязательно: True
    

• rotate clock-wise rotatation of draw origin
  параметры:
  • X rotation angle
    тип: float
    единица: deg
    обязательно: True
    
• rpolygon create polygon shape
  параметры:

  • X x-coord of center in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord of center in pixel or percents of height
    тип: atom
    обязательно: True
    

  • N number of vertexes
    тип: int
    обязательно: True
    

  • R polygon radius
    тип: float
    обязательно: True
    

• scale scale current draw matrix
  параметры:

  • X x
    тип: float
    обязательно: True
    

  • [Y] y. If omitted, uses X-value to scale same in both directions
    тип: float
    

• star create star shape
  параметры:

  • X x-coord of center in pixel or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord of center in pixel or percents of height
    тип: atom
    обязательно: True
    

  • N number of vertexes
    тип: int
    обязательно: True
    

  • [R] star radius
    тип: float
    

  • [STEP] connection step. If omitted step is auto-calculated
    тип: int
    

• stroke stroke shape with color
  параметры:

  • COLOR stroke color
    тип: atom
    обязательно: True
    

  • [PRESERVE] preserve path after stroke
    тип: atom
    

• text set current text shape
  параметры:

  • X x-coord in pixels or percents of width
    тип: atom
    обязательно: True
    

  • Y y-coord in pixels or percents of height
    тип: atom
    обязательно: True
    

  • TXT text content
    тип: list
    обязательно: True
    

• translate translate draw origin
  параметры:

  • X x offset
    тип: float
    обязательно: True
    

  • Y y offset
    тип: float
    обязательно: True
    

• update updates drawed image
  

свойства:

• @send Запросить/установить send destination
  тип: symbol
  по умолчанию: (null)
  

• @receive Запросить/установить receive source
  тип: symbol
  по умолчанию: (null)
  

• @size Запросить/установить element size (width, height pair)
  тип: list
  по умолчанию: 120 60
  

• @pinned Запросить/установить pin mode. if 1 - put element to the lowest level
  тип: bool
  по умолчанию: 0
  

• @background_color Запросить/установить element background color (list of red, green, blue values in 0-1 range)
  тип: list
  по умолчанию: 0.93 0.93 0.93 1
  

• @border_color Запросить/установить border color (list of red, green, blue values in 0-1 range)
  тип: list
  по умолчанию: 0.6 0.6 0.6 1
  

• @fontsize Запросить/установить fontsize
  тип: int
  диапазон: 4..100
  по умолчанию: 11
  

• @fontname Запросить/установить fontname
  тип: symbol
  варианты: Courier, DejaVu, Helvetica, Monaco, Times
  по умолчанию: Helvetica
  

• @fontweight Запросить/установить font weight
  тип: symbol
  варианты: normal, bold
  по умолчанию: normal
  

• @fontslant Запросить/установить font slant
  тип: symbol
  варианты: roman, italic
  по умолчанию: roman
  

• @label Запросить/установить label text
  тип: symbol
  по умолчанию: (null)
  

• @label_color Запросить/установить label color in RGB format within 0-1 range, for example: 0.2 0.4 0.1
  тип: list
  по умолчанию: 0 0 0 1
  

• @label_inner Запросить/установить label position (1 - inner, 0 - outer).
  тип: bool
  по умолчанию: 0
  

• @label_align Запросить/установить label horizontal align
  тип: symbol
  варианты: left, center, right
  по умолчанию: left
  

• @label_valign Запросить/установить label vertical align
  тип: symbol
  варианты: top, center, bottom
  по умолчанию: top
  

• @label_side Запросить/установить label snap side
  тип: symbol
  варианты: left, top, right, bottom
  по умолчанию: top
  

• @label_margins Запросить/установить label offset in pixels
  тип: list
  по умолчанию: 0 0
  

входы:

• draw commands
  тип: control

ключевые слова:

ui canvas draw

Авторы: Serge Poltavsky

Лицензия: GPL3 or later