Click To Jump :
1. Set Up and Basic Navigation
1.1 Understanding the Pscale Workspace
1.2 Desktop and Mobile Modes
1.3 Light and Dark Theme
1.4 Basic Navigation and Guesture
2. Upload Image or Old Project
2.1 Upload a New Image
2.2 Image Metadata
2.3 Import Previous Work
3.1 2D Reference Line
3.2 Standard Units
3.3 Custom Units
3.4 3D Perspective Plane
3.5 Perspective Grid
3.6 Refining the Perspective Reference
3.7 Replacing an Existing Reference
4.1 Select / Edit
4.2 Point Info
4.3 Line Measurement
4.4 Angle Measurement
4.5 Polygon Measurement
4.6 Freehand Measurement
4.7 Circle Measurement
4.8 Ellipse Measurement
4.9 Adjusting the Ellipse
4.10 Advanced Shape Recognition
4.10 Editing Measurement Points
4.11 Undo, Redo & Delete
5.1 Save Current Work
5.2 Export CSV
5.4 Export Metadata
5.4 Export Image
Pscale is divided into three main working areas:
The left section contains the main controls for:
Image Upload
Import Previous Work
Select / Edit
Pan / Zoom View
2D Ref Line
3D Plane
Perspective Grid
Drawing Tools
Loupe Zoom
Image Metadata
Delete Selected
The centre is the main working area where you see:
The original photograph
Measurement geometry
Reference geometry
Perspective grid
Measurement values
Editable points
Rulers
Loupe
The right section contains:
Measurements
References
Calculated data
Reference inputs
Colors
Light/Dark theme
Export controls
Save Current Work
Pscale has separate desktop and mobile interfaces.
The full three-panel workspace remains visible.
The interface is reorganized for a smaller screen:
The + button opens the tools.
The image workshop occupies the main upper portion.
Measurements and references appear in the lower scrollable section.
The desktop layout is not changed by the mobile interface.
The mouse and touch controls are handled separately; use the dedicated control guide for those interactions.
The Measurements section contains the:
Light / Dark
theme switch.
This is the default theme and uses white/gray interface tones while keeping the main yellow accent.
Switches the interface to the dark presentation.
The theme changes the interface appearance; measurement and reference colors remain separately configurable.
Before taking measurements, you can reposition and inspect the photograph.
Loupe Zoom
The current tool set includes a loupe zoom control beneath the drawing tools.
Use the Pan / Zoom View tool when you want to navigate around the photograph rather than create geometry.
The application also provides rulers around the workspace and a loupe for detailed inspection. The loupe magnification can be adjusted using:
Use the mouse wheel to zoom.
Pan/zoom can be used to reach small areas of the photograph before selecting or moving measurement points.
Pscale separates drawing from navigation:
One finger → measurement/editing
Two fingers → navigation
Two fingers can be used for pinch zooming and synchronized movement for panning. For Detailed Controll Guide Click Here.
Start with:
Image Upload
Select the photograph you want to measure.
Pscale loads the original image into the central Image Workshop.
After the image is loaded, the metadata panel displays:
Image Metadata:
Information can include:
File name
File size
Image type
Resolution
Aspect ratio
Megapixels
Pixel scale
Camera information when available
Lens information when available
EXIF information when available
Shot date when available
GPS information when available
Software/color-space information when available
The application only reports metadata available from the image rather than inventing missing information.
For a project that has already been saved, use:
Import Previous Work
This restores the saved project so that you can continue editing.
A previous project can contain the image together with its associated editing information, such as:
Measurements
Measurement positions
References
Calibration
Perspective plane
Perspective settings
Custom units
Colors
Other saved project state
Use Image Upload when starting a new project.
Use Import Previous Work when you already have a saved Pscale project and want to continue working on it.
Calibration establishes the relationship between the photograph and the real-world dimensions you want to measure.
Pscale provides two main calibration/reference methods: 2D Ref Line & 3D Plane
Use 2D Ref Line when a simple scale is appropriate for the measurement.
Select 2D Ref Line.
Place the first reference point.
Place the second reference point.
Enter the known physical distance.
Select the required unit.
Apply the calibration.
The reference establishes the image scale for the measurements.
The reference input supports standard units such as:
Centimeters
Meters
Inches
Feet
Pscale also supports:
Custom unit
You can type any unit name required for your project.
Examples:
tiles
panels
boards
blocks
books
units
The custom unit becomes the unit used for the calibrated measurements.
Use 3D Plane when a flat surface has been photographed from an angle and perspective distortion needs to be considered.
Typical examples include:
Floors
Walls
Tables
Panels
Roads
Flat structural surfaces
Select 3D Plane.
Place four points around the photographed plane.
Adjust the four points to match the actual plane boundaries.
Enter the required physical side dimensions.
Check the corrected plane using the Perspective Grid.
The four sides are identified as:
Side 1
Side 2
Side 3
Side 4
Each side has its own visual color.
The colors are independently changeable.
The side values are reference information and therefore remain editable.
The Perspective Grid can be switched ON/OFF.
The grid is parallel.
The grid follows the corrected perspective plane.
This provides a visual way to check the plane being used for perspective-aware measurement.
After placing the four points:
Zoom in.
Select the required point.
Move it precisely.
Continue to the next point.
Recheck the entire plane.
You can zoom while continuing to work with the four-point reference; the already registered points are retained.
*** Pscale is designed to maintain only one active calibration/reference system at a time.
Creating another reference replaces the existing reference rather than accumulating multiple active calibration references.
Normal measurements are separate and remain available.***
Once the image has been uploaded and, where necessary, calibrated, choose the appropriate measurement method.
Use:
Select / Edit
to select existing measurements and references.
Once selected, their editable points can be adjusted.
Select:
Point Info
Then place one point.
The point tool can provide pixel information at that location.
This is useful when you need to identify:
exact pixel coordinates
pixel color
RGB value
HEX color value
Measure a straight distance.
2 points
Place:
Point 1 → Point 2
Pscale calculates the distance.
With calibration, the result is shown in the selected real-world unit.
Measure an angle.
3 points
Use:
Point 1 → Vertex → Point 3
The middle point defines the angle vertex.
The calculated result is shown in degrees.
Measure the dimensions of an irregular or multi-sided shape.
Draw the shape around the object boundary.
When the polygon is closed, Pscale can calculate:
Individual side values
Perimeter
Area
Trace an irregular shape naturally by drawing around it.
A freehand drawing is treated as one complete shape.
Its measurement data can include:
Perimeter
Area
2 points
The points define the circle's centre/radius relationship.
The measurement data includes:
Perimeter
Area
3 points
The three points are:
Defines the centre of the ellipse.
Defines one point on the ellipse perimeter and establishes one semi-axis.
Defines the second perpendicular semi-axis and also lies on the ellipse perimeter.
The Centre → Vertex and Centre → Co-vertex directions remain perpendicular.
Moves the entire ellipse.
Changes the primary axis and allows the ellipse to rotate.
Changes the second axis while remaining perpendicular to the first axis.
The ellipse therefore remains geometrically constrained rather than behaving like an unconstrained oval.
Its measurement data includes:
Area
Perimeter
Purpose:
Automatically identify and measure contrasting shapes such as circles, ellipses, polygons, rectangles, and triangles from the image.
Open Advanced Features → Auto-Detect Shapes.
Select the required Shape Type.
Adjust Contrast Sensitivity until the shape is detected clearly.
Use Detect by Click and click on the shape for better identificataion, or use Detect All to scan the whole image.
Pscale identifies the shape and draws its measurement overlay on the image.
Adjust Contrast Tolerance for better detection. You can do thing even after selecting each shape
The detected shape and its calculated measurements appear in the Measurements List and can be adjusted like a normal measurement
To adjust a measurement:
Select it.
Select the required point.
Move the point.
Release it at the desired position.
Pscale recalculates the data.
This is useful for refining measurements after zooming in.
Use Undo ↶ or Redo ↷ ( in the "Image Workspace" region bootm right ) to step backward or forward through supported editing changes.
To delete a measurement or reference:
Select it in the Measurements section.
Use Delete Selected in the " Tools and References ".
Confirm the deletion.
After completing measurements, use:
Save Current Work
This is different from exporting measurement results.
Saving is intended to preserve the project so that it can be continued later.
Saving Type :
Pscale uses a dedicated project/work file format:
This is a Pscale project file rather than a normal image export.
It is intended to keep the original image together with the editable project information.
Continue an Existing Project :
Later, open Pscale and use:
Import Previous Work
Select the saved .pscale project.
Pscale restores the work so that the measurement process can continue.
This is useful when a project contains many carefully positioned points and references that would otherwise be time-consuming to recreate.
Use:
Export Metadata
to create a text-based metadata/project report.
This is useful for documentation and archiving.
Use:
Export CSV
when you want the calculated measurement information in a spreadsheet-friendly format.
The exported information can include:
Measurement ID
Name
Type
Pixel dimensions
Real dimensions
Units
Areas
Angles
Colors
Coordinates
Pixel information
Measurement/reference mode
This is useful for further analysis, reporting, or record keeping.
Use:
Export Image
when you want a visual version of the measurement work, including the measurement/reference overlays.
This is useful for:
Reports
Presentations
Documentation
Sharing
Project records
Pan image
Hold left mouse button and drag on an empty area
Zoom in/out
Use the mouse wheel
Draw a measurement
Select a measurement tool, then click the required points
Finish a measurement
Complete the required number of points / click the starting point where applicable
Select a measurement/reference
Click its line, shape, or point
Move a point
Select the measurement/reference, then drag the desired point
Perspective reference
Place the four perspective points one by one
Move perspective point
Select the perspective reference, then drag an individual point
Edit a value
Click its value field in the Measurements section and type the value
Delete selected item
Select the item in Measurements, then use Delete Selected and confirm
Change reference color
Use the color control associated with the reference/side
Suggetions:
Switch to "Mobile" option present just above the Image Upload option for better experience in mobile ( or vertical displays ).
Keep the Switch to "Desktop" for better experience in desktop ( or horizontal displays ).
Pan image
Touch with two fingers and move both fingers together while keeping their distance approximately constant
Zoom in
Place two fingers and move them apart
Zoom out
Place two fingers and move them together
Draw a measurement
Use one finger only
Place a point
Touch with one finger, position it, then lift the finger — the release position becomes the point
Cancel point registration
If another finger touches the screen during point placement, the gesture becomes navigation and no point is registered
Select a measurement/reference
Tap it
Select a particular point
With the item selected, touch close to the desired point
Move a selected point
Keep your finger touching the point and move it; the point follows your finger
Commit moved point
Lift your finger; the point remains at its final position
Zoom while working with perspective points
Use two fingers; already registered perspective points are preserved
Switch between perspective points
Zoom/pan as needed, then touch the next point you want to move
Edit a value
Tap the value field and type
Delete selected item
Select it in Measurements → tap Delete Selected → confirm