SIEE:Help

Description
GUI:
SIEE widow is divided into three main parts:
  1. top: displays the name of last opened file, and the count down timer
  2. Canvas(center):
    1. top toolbar
      1. undo button(only one undo)
      2. selection area(x,y,w,h)
      3. visible channels(rgba)
    2. left toolbar
      1. select(allow selection of a image area)
      2. zoom(image zoom)(hold SHIFT to zoom out)
      3. pipet(left of right click to set values for forground and background buttons)
      4. info(when moved over image display the pixel position and its RGBA values)
      5. forground color
      6. background background
      7. switch background and foreground values
    3. center image area(the actual Canvas): displays the image, its size, and the zoom value
    4. "Canvas Options" area(can be minimized)
      1. main
          border(options for border around image)
        1. info(options for info button)
        2. zoom(options for zoom button)
      2. selection: different options for how selected area is drawn
      3. render: different options for how the image is drawn on the screen
      4. stroke: different options for how lines are drawn
      5. view: allows to hide the top and/or left toolbars
  3. "Tools" area(can be minimized):
    1. basic tab:
      1. Main
        1. new: creates a new image of a specific size filled with foreground color
        2. resize: changes size of sculpt
        3. rotate: rotates sculpt{rotating 90 degrees turns object inside-out}
        4. ratio: in case you selected the wrong number of columns when importing a sculptie
        5. slice: cuts slices of specific w/h from image and rearanges them either vertically or horizontally
      2. Others
        1. fit: removes all the white space from around center black pixels
        2. border: draws a border(s) around the image
      3. Sculpt
        1. skin: creates the inside skin of a plane
        2. relief: given a grey scale image creates a plane sculptie
        3. balloon: puts a balloon around sculptie, and removes air until the ballon is tight against it:)
        4. whole:
          1. rows close: closes the top and bottom rows
          2. cols close: closes the left and right cols
          3. rows connect: connects the top row to the bottom row
          4. cols connect: left column to the right column
    2. selection tab{almost all the operation performed on sculpt use the selection rectangle}:
      1. normal tab:
        1. crop: crops the image
        2. copy: copies selection rectangle to the clipboard. Copies only the visible channels.
        3. paste: pastes a image from the clipboard, using visible channels
        4. flip: flips sculpt along the selected axis
        5. set: sets all visible channels equal to this one
        6. shift: sifts rows/columns to left/right/up/down
        7. switch: switches values between two channels
      2. color[0] tab:
        1. grey: makes selection gray
        2. bright: makes selection whiter
        3. dark: makes selection darker
        4. b/w: makes selection black and white
        5. color selection section{determines what colors are affected when pressing 'Color' button}:
          1. clear: clear values for RGBA text fields
          2. RGBA{text fields located in the same section as 'Clear' button}:
            • if empty is ignored
            • if starts with 'i' applies to everything inside range
            • if starts with 'o' applies to everything outside range
            • put '-' between first and last value in range
        6. color: applies values from following RGBA text fields to selection
        7. RGBA text fields:
          • if empty is ignored
          • if only a number, the color channel is set to this value
          • if starts with '+' value is added to existing color channel
          • if starts with '-' value is substracted from existing color channel
          • if starts with '*' value is multiplied to existing color channel
          • if starts with '/' color channel is divided by value
      3. color[1] tab:
        1. rand: adds/sets pixel to random values
        2. bands: posterizes the image
        3. ch2txt: converts pixels values for a specific channel to text(default is comma delimited)
        4. txt2ch: sets pixels values based on a string of values(default is comma delimited)
      4. filter tab:
        1. text area values:
          • contains values used by filter
          • each line contains a number of int/double/float values separated by coma followed by a white space
          • each line must contain the same number of values
          • the standard size is a 3x3 matrix{a table with 3 rows and 3 columns}
          • you can use your own values:)
        2. types drop-down list:
          1. click on me to change value for one of these types of filter
          2. edge: values for edge detection
          3. blur: values for blurring(erodes a sculptie)
          4. sharp: values for shapening
          5. emboss: values for embossing
        3. edge pixels checkbox: if true pixels around the image edge are set to zero, otherwise they are not changed
        4. apply filter button: applies filter to the selection
      5. info tab:
        1. info: gets min, max, and average for each channel of each pixel in the selection
        2. histogram: shows this histogram of the image
      6. tools tab:
        1. morph: given two images, creates a new image that is somewhere between the two of them
        2. merge: merges two images using different functions
        3. fold: folds a selection inside/out, used for making tiles
        4. tile: another way to make tiles, using a triangular selection
      7. scultp tab:
        1. mirror: it mirror a sculptie along the selected channels/axis
        2. center: centers a sculptie at point x/y=127.5
        3. converge: converges the selected pixels toward their center
        4. rotate: rotates selected vertices around their center
        5. stretch: forces an sculptie to strech along visible axis(non-symetrical objects can give strange results)
        6. fill: fills the bounding box with the object(the bounding box is 256x256x256)
        7. soften: softens all the sharp edges of a sculptie
      8. matrix tab:
        1. matrix, performs different things on the selected pixels:
          1. delete: deletes the selected rows/cols from the image
          2. merge: merges together two or more rows/cols
          3. half: removes every other row/col
          4. double: inserts another copy of the selected rows/cols
          5. divide: between every row/col selected inserts another row that is their average`
    3. export tab:
      1. mesh type: the exported object will be made either of triangles or rectangles{smaller file size}
      2. row: closes or welds the last and first row
      3. col: closes or welds the last and first column
        NOTE: if close is used than object can't be imported back:(
    4. options tab:
      1. tooltips: when mouse pointer is over something, it will display a small description
      2. font: allows the user to change the font used
      3. view EULA: you can view again the EULA
      4. auto-copy: each time changes are made to the images, the image is copied to clipboard
  • bottom:
    1. open button: opens a sculpt
    2. save button: saves a sculpt
    3. import button: imports a sculpt from a .obj file
    4. export button: exports the currently loaded sculpt to a .obj file
    5. 3d view button: opens/closes the 3D wireframe preview panel
  • 3D Preview(right):
    1. Image panel
      1. displays the sculptie in wireframe view
    2. Wireframe panel
      1. World tab
        1. Main tab
          1. Scale: allows the user to change the scalling factor for sculptie
          2. Cull:
            1. back: any vertices/edges that are less than zero on the viewing axis are not drawn
            2. front: any vertices/edges that are greater than zero on the viewing axis are not drawn
            3. none: no culling is done. all vertices/edges are drawn normally
          3. B: allows to change the background color
          4. Offset: allows user to change how much is everything in world shifted from bottom-left corner
          5. 0: resets the offset to zero
          6. C: sets the offset to the middle of image panel
        2. View tab
          1. Center: draws the axis at the world center if selected. the selected stroke, and lenght can also be set
      2. Obj tab
        1. rot tab
          1. x: changes sculptie rotation around x-axis
          2. y: changes sculptie rotation around y-axis
          3. z: changes sculptie rotation around z-axis
        2. pos tab
          1. x: changes sculptie position along x-axis
          2. y: changes sculptie position along y-axis
          3. z: changes sculptie position along z-axis
        3. size tab
          1. x: changes sculptie size along x-axis
          2. y: changes sculptie size along y-axis
          3. z: changes sculptie size along z-axis
        4. view tab
          1. Center: draws the axis at object center if selected. the selected stroke, and lenght can also be set
          2. Lines: draws the lines/edges of object if selected. the selected/unselectd color, and type of line can also be set
            1. Stroke: allows to change how lines/edges are drawn
          3. Point: draws the point/vertices of object if selected. the selected/unselectd color, size, and type of point can also be set
      3. Img tab
        1. size: allows the user to change the size of the preview window
    KEYBOARD SHORTCUTS:
    1. "Ctrl+N" creates a new image
    2. "Ctrl+O" shows the open file dialog box
    3. "Ctrl+S" shows the save file dialog box
    4. "Ctrl+I" shows the import file dialog box
    5. "Ctrl+E" shows the export file dialog box
    6. "Ctrl+C" copies current selection to the clipboard, or the whole image if nothing is selected
    7. "Ctrl+V" paste the image from clipboard
    8. "Ctrl+A" selects the entire image
    9. "Ctrl+Z" undo
    How to:
    1. Make sculpties
      1. Make your object in AOI(you can use other prgrams, but you MUST make sure it is an object that has a rectangular mesh)
      2. Export it to an .obj file
        1. Use 0.05% error
        2. Select make rounded edges
      3. In SIEE click on import button
      4. Select .obj file you want to import
      5. Once the "Column Selection" dialog opens, try different column values
        NOTE: the sculptie image shouldn't have any have any stripes or bands
      6. make sure that "invert N" is selected(depending on what 3d modeler you used)
      7. Close/connect rows/columns(optional)
      8. Resize img to 64x64(can also just double in size)(optional)
      9. Set alpha channel to equal to your trademark image, or black(invisible)
      10. Save as an .png image
    IMPORTANT
    The importer works only for objects that have NxN vertices.
    That means that each vertex on row N, must be connected to the next vertex on the same row.
    And, each vertex on column N, must be connected to the next vertex on the same row
    It should look like a fishing net, where each hole has four edges and four knots.
    I used AOI to make my sculpts.
    In that program you can create NxN meshes of different type, and than you can modify the vertices.
    The important thing is that, you never add/delete one single vertex.
    You have to delete/add one entire row of column of vertices.
    Otherwise, my importer doesn't work.

    OTHER THINGS
    If you see a divider line in the applets that means you can increase/decrease the size of that window
    The "Ratio" button is quite usefull if you imported the sculptie using the wrong proportions
    ATTENTION: when using "ratio" you might need to first flip image along y-axis
    When resizing, go to "image area options", than render tab, click on "..." button, and change interpolate type, to get slightly different images
    At this time it can't automatically import .obj files, you need to specify how many columns of vertices does your sculptie have

    Glossary
    S.I.E.E = Sculpt Importer Exporter and Editor
    sculpt = a image file that where each pixel represents a vertex position in a rectangular mesh
    RGBA = red, green, blue, alpha
    alpha = transparency
    GUI = graphical user interface{what you see on the screen}
    AOI = ArtOfIllusion{a free modeling 3D program}
    EULA = End User License Agreement
    < Home / Projects / SIEE / Help >
    Copyright © 2013 llsl:Rex Cronon. All rights reserved.
    edited: 07/19/2013 @ 08:05:37
    visits: 146