Qckvu Get Commands

Commands that begin with get_ are are requests to the Qckvu server to return data. The return data might be an ASCII string (if you have requested a list of structure names) or a bitmap if the client has requested a screen draw.



Command Argument Details

Get_Window

None

returns the "corners" of the current window in user units: LLx, LLy, URx, URy. This might not necessarily match the previous Set_Window command because the display size (in pixels) could have a different aspect ratio than the set_window command that was issued.

Get_Image

None

Instructs the server to return the current display window as a bitmap. The "scale" and window should already have been specified. The image format returned in GIF.

Get_Layer_List

None

Returns a list of layers and datatypes that contain data.

Get_Structure_Root

None

Returns the name of the top level structure. If there is more than one top level structure, returns a list of structures, separated by commas.

Get_Structure_List

None

Returns a complete list of structures (alphabetically)

Get_Structure_Children

Structure Name

Returns the children of the structure name passed to the server.

Get_Structure_Extents

Structure Name

returns coordinates (in layout DBU) of bounding box of specified structure to the client. LL, UR

Get_Vector

None

Instructs the server to return a stream of primitives. Primitives include boundaries, paths and text. Each primitive is tagged with its layer number and data type and the structure it belongs to. The clipping flag should already be set so that the server knows whether the polygons need to be clipped at the window boundary or not. The primitives are returned in DBU. See the detailed syntax on the Get_Vector Page.

Get_Vertex_Info
  04-15-02

None

return a stream of polygon primitives that are "nearest" to this point. Each primitve will include the structure, layer and datatype tag. Search radius is several pixels. This command only searches polygons that are "visible."

Example

Get_Vertex_Info
5600,6708

Get_DBU

None

This command tells QIS to return the database information stored in the header of the GDSII file. Two numbers are returned.

1st number is the user unit resolution. For example if you are working in um and you set a resolution of 0.001 um then the first number would be 0.001. If you are working in mils and you need 0.1 mil resolution the first number will be 0.1.

Second number: length of a database tick in meters. In the first case since you need 0.001 um resolution 1 database tick is 10E-9 meter. In the second case, the number would be 2.54E-5 m because you need 10 of these to make one mil.

Here are some examples:
User's Setup              DBU Info Returned
micron@ 0.001 res.         0.001,1E-9
micron@ 0.25  res.         0.25,2.5E-7
mm@     0.001 res.         0.001,1E-6
mil@    0.1   res.         0.1,2.54E-5

Get_Colfill_Pat

None

return the contents of the file known as colfill.pat which contains the fill patterns used by QIS. The server first echos the command, then sends the files size in bytes, followed by the contents of the file. The client can use these fill patterns so that it displays the data in the same way that Qckvu would.

Example

client: 
Get_Colfill_Pat /n

server: 
Get_Colfill_Pat /n
23456\n
#0 WHITE
....
....
....
....
#1 BLACK
KKKK
KKKK
KKKK
KKKK