STK Graphics PrimitivesSend comments on this topic.
PixelSizePerDistance Property (IAgStkGraphicsCamera)
See Also
Windows





Windows & Linux

Description

Gets the approximate number of meters covered by a pixel that is 1 meter away from the camera. This is commonly multiplied by the distance from the camera to an object to compute the approximate number of meters covered by a pixel of the object.

Property type

Read-only property

Syntax

[Visual Basic .NET]
Public Property PixelSizePerDistance() As Double
[C#]
public double PixelSizePerDistance {get;}
[Managed C++]
public: __property double get_PixelSizePerDistance();
[Unmanaged C++]
public: HRESULT get_PixelSizePerDistance(
    double * pRetVal
);
[Java]
public double getPixelSizePerDistance();
[Python - STK API ]
@property
def PixelSizePerDistance(self) -> float:

Remarks

Example 1:

Assume PixelSizePerDistance is 0.001. This means at 1 meter away, the size of a pixel is 0.001 meters. Therefore, the size of 1 pixel at 2,000 meters away is:

2,000 meters * 0.001 (meters / pixel / meters) = 2 meters/pixel

Example 2:

Assume PixelSizePerDistance is 0.001. This means at 1 meter away, the size of a pixel is 0.001 meters. The diameter, in pixels, of a sphere 2,000 meters away that has a diameter of 10 meters is:

10 meters / (2,000 meters * 0.001 (meters / pixel / meters)) = 5 pixels

PixelSizePerDistance is accurate for a pixel in the center of the window. Accuracy decreases slightly the farther off center a pixel is and the wider the camera's field of view is.

See Also

© 2024 Analytical Graphics, Inc. All Rights Reserved.