Cyberslug SlugView 3.4.2 Cyberslug

Version History:


Program Purpose:

Visualizer and editor for multiple point clouds and gridded height-fields with many millions of points. Edits using tools for manually trimming, measuring, and fitting the dataset.

Copyright (c) 2017, University of California, Santa Cruz and Neva Ridge Technologies

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those of the authors and should not be interpreted as representing official policies, either expressed or implied, of the University of California, Santa Cruz or Neva Ridge Technologies.


TABLE OF CONTENTS

  1. Running from the command line
  2. Running from MATLAB
  3. Compatible file types
  4. Using the program
  5. Troubleshooting
  6. Key and Mouse Bindings

1) Running From the Command Line

[filename] is either the name of a .header, .svn, or any other filetype to be defined.

The only [option] is -c. This option will convert the raw test file in to a smaller, faster .svn file, which is native to SlugView. More about file types in section 3: File Types.

Return to Table of Contents

2) Running SlugView from MATLAB

** Note: When specifying a behavior with MATLAB, clicking "Done" in SlugView will exit and return the specified data. Clicking "Cancel" will exit without returning the specified data. **

Start MATLAB from ~/slugview

Run one of the following commands:

Return to Table of Contents

3) Compatible File Types

SlugView is capable of handling any text file format that is 9 dimensions or less. Every file is required to have at least xyz dimensions. It can also include RGB data, intensity data (typically from LIDAR), and two additional data parameters. RGB can be in floating point (decimal 0.0-1.0) form or byte (integer 0-255) form. Intensity can be numbers or characters. Additional parameters must be numbers.

SlugView also has a native filetype, .svn (slugview native). SVN's store the information in binary; therefore are faster and smaller than their text file counterpart. It is recommended all files are converted to .svn. However, the .svn file format does NOT contain the additional parameters. Additionally, when this file format is written, any constraints that have been applied to the data will be ignored.

.headers: .header/.data file pairs have been removed from SlugView and replaced with .svn. SlugView will still open .header/.data pairs, but will no longer save in that format.

Return to Table of Contents

4) Using the Program

5) Troubleshooting

6) Key and Mouse Bindings

TOOL KEY/BUTTON FUNCTION
Draw Line draw line Left-Click Draws a single point.
Draw Line draw line Left-Click and Drag Draws a line with the initial point fixed. Moveable until mouse is released.
Draw Line draw line Middle-Click and Drag Pan the image. *Note: Some systems use Left-click + Right-click as Middle-click.*
Draw Line draw line Right-Click and Drag Zoom in and out.
Measure draw line Double-Click Moves the axis of rotation to the clicked spot.
Measure draw line Left-Click Creates a series of connected points to measure.
Measure draw line Left-Click and Drag Draws a movable line with the initial point fixed. Movable until mouse is released.
Measure draw line Middle-Click and Drag Pan the image. *Note: Some systems use Left-click + Right-click as Middle-click.*
Measure draw line Right-Click and Drag Zoom in and out.
Rotate draw line Arrow-keys Rotate the point cloud around the x and y axes.
Rotate draw line Arrow-keys + Z Rotate the point cloud around the z axis.
Rotate draw line Control (Ctrl) Draws a blue cone to show the axis of rotation. *Note: This cone can be very difficult to see!*
Rotate draw line Double-Click Moves the axis of rotation to the clicked spot.
Rotate draw line Left-Click and Drag Rotate the point cloud around the x and y axes.
Rotate draw line Middle-Click and Drag Pan the image. *Note: Some systems use Left-click + Right-click as Middle-click.*
Rotate draw line Right-Click and Drag Zoom in and out.
Rotate draw line Shift + Left-Click Displays the xyz coordinates of the clicked point.
Rotate draw line Shift + Left-Click and Drag Modify the camera look-position as if you're moving you are shaking your head left/right or nodding up/down. Rotation center (target) moves with your head.
Rotate draw line Shift + Middle-Click and Drag Move towards and away from rotation center (target).
Rotate draw line Shift + Control (Ctrl) + Middle-Click and Drag Rotate over / under the rotation center (target). Similar to Left-Click and Drag rotation around x axis only.
Selector draw line Left-Click and Drag Acts as a freehand tool or rectangle drawing tool to draw a polygon.
Selector draw line Middle-Click and Drag Pan the image. *Note: Some systems use Left-click + Right-click as Middle-click.*
Selector draw line Right-Click and Drag Zoom in and out

Return to Table of Contents