Worksession

Toolbar Menu

File
Worksession

File

Worksession >

<Options>

The Worksession command manages a list of models that are being used as reference geometry.

Note

  • The Worksession command lets more than one user work on a large project. By breaking the project down into many files, one user can edit a part of the project while another user edits a different file. Only one user can have a file open for editing, but many users can see it.
  • The attached file can be in any format that Rhino can import, not just Rhino models. Attached geometry cannot be edited (for example, Move, Scale), but it can be used for input to creation commands (for example, Copy, ExtrudeCrv).
  • When a worksession object is dragged, it snaps back into place.
  • Each user maintains his own worksession (.rws) file. These are not meant to be shared. The Rhino files used as reference geometry are shared, but the .rws files are not.
  • Worksessions cannot be used as layout elements.
  • Objects can be copied from a worksession file and pasted into the active file.

For a description of the process Rhino 5.0 uses to locate files used by worksessions and linked instance definitions, see Rhino Wiki: File finding.

Layer settings

The attached file geometry appears on a unique set of layers under a parent layer with the name of the attached file, and the attached file layers as sub-layers of the parent.

You can change the layer state of reference layers (Color, On/Off, and Locked/Unlocked), but you cannot add new layers to or delete layers from the attached file. The list of attached files are not saved in the current model file, but are saved in the worksession file (.rws).

Steps

  1. In the Worksession Manager dialog box, click Attach.
    Or
    Drag any supported geometry file format from Windows Explorer, and in the dialog box, click Attach file.
  2. Select files to attach.
  3. To save the worksession for future use, click Save or Save As.
    The current worksession name appears in the dialog box title.

When you open a worksession file:

  • Your current model closes. You are prompted to save changes.
  • Your current worksession is cleared.
  • The files listed in the worksession file are opened. The active file is open for editing and the others are attached for reference.
  • The layer states for the files are set.
  • The Undo command has no affect on worksession actions.

Worksession Manager

Status

Marks the file that is currently open for editing.

Locked

Displays the locked/unlocked status of the attached files. A tooltip on the lock icon shows information about who has the file open.

Alias

The attached model name.

Path

The path to the attached file.

Attachments

Attach

Attaches an external file to the worksession list.

Detach

Removes the external file from the worksession list.

Active

The selected model is open for editing.

Note: Only .3dm files can be made active. Other file formats may be attached, but cannot be the active file.

The current model closes and becomes an attached model. You are prompted to save changes in the currently active model.

Update

Refreshes the selected attached files.

Lock Info

Displays the locked/unlocked status of the attached files and information about who has the file open.

Session

Open

Opens a worksession file.

Save

Saves a worksession file.

Save As

Saves a worksession file as another name.

Close

Closes the Worksession Manager.

Resolving render content conflicts

Rhino detects material, environment and texture name conflicts in the following file operations:

When a render content item name already exists in the current model, but the content settings are different, the conflicted items will be resolved based on the related advanced settings.

Search for PasteConflictOption (for paste) and ImportRenameConflictingEx (for import and insert) in Advanced settings and change the value as described below.

0 = Do not import incoming conflicted render contents.

1 = Import and rename incoming conflicted render contents with [imported] post-fix.

2 = Import incoming conflicted render contents and overwrite existing ones.

3 = Pop up the Render Content Name Conflict dialog and let you decide how to resolve the conflicts.

Related commands

LimitReferenceModel

Toolbar Menu

Worksession

File

Worksession > Limit

The LimitReferenceModel command limits the amount of reference geometry that is available to work on by purging the reference geometry that is not needed in the area of interest.

This can make Rhino's display more responsive or simply cull unwanted visual clutter.

Steps

  • Draw a crossing sphere that defines the area of interest.
    Objects not enclosed or touched by the sphere will be purged from memory.
Command-line options

ApplyLimit

Sets the limits of the model.

RemoveLimits

For models with previously applied limits, reloads the current worksession file, restoring the purged objects.

PurgeRefObjects

Toolbar Menu

Not on toolbars.

Not on menus.

The PurgeRefObjects command deletes selected worksession reference objects from Rhino.

This command is useful for hiding unwanted worksession geometry during the work session.

Steps

  • Select the worksession reference objects.

Warning

The Undo command does not work for the PurgeRefObjects> command. To recover the purged objects, activate another attached file or click the Refresh All button in the Worksession Manager dialog to reload the worksession model.

See also

Work with files

Manage views

Rhino Wiki: File finding