Drawable.PixelSize Property

Gets or sets a drawable-specific pixel size.

Syntax

public System.Double PixelSize { get; set; }

Property Value

Type: System.Double
Default: 0.0
The size of a drawable pixel in meters.

Remarks

This property specifies the size of a pixel, in meters. It is similar to the static ScreenPixelSize property, but makes it possible to override the pixel size for an individual drawable. If not specified, or set to 0.0, the value of ScreenPixelSize will be used.

The pixel size is used to calculate the map scale, given the view area and the size of the drawable. If you're only displaying a map in a windows on the screen, you don't need to set this property. But if you want to create a high definition image, perhaps for display on an Android device with a much higher DPI, or for sending to a printer, you can use this property together with PixelSizeAdjustments. The following C# example generates a 300 DPI image, while keeping the size of text and symbols the same as on the screen:

Generating a high-resolution map image

// Generate a 300 DPI map image
   System.IO.Stream GenerateHiResImage(Carmenta.Engine.View v)
   {
       // Create a new bitmap drawable, about 10 centimeters
       double metersPerPixel = 0.0254 / 300;
       BitmapDrawable bm = new BitmapDrawable((int)(0.1 / metersPerPixel), (int)(0.1 / metersPerPixel), Renderer.Software);

       // Set the pixel size, to make scale calculations work as if the image is 10 centimeters.
       bm.PixelSize = metersPerPixel;

       // Set rendering scale factors to make texts and symbols the same size as on the screen.
       double scaleFactor = Drawable.ScreenPixelSize / metersPerPixel;
       PixelSizeAdjustments psa = new PixelSizeAdjustments();
       psa.PolygonScaleFactor = scaleFactor;
       psa.ResolutionScaleFactor = 1.0; // Resolution will be adjusted by the PixelSize property above
       psa.SymbolScaleFactor = scaleFactor;
       psa.TextScaleFactor = scaleFactor;
       bm.PixelSizeAdjustments = psa;

       // Create the image
       Carmenta.Engine.View clonedView = v.Clone() as Carmenta.Engine.View;
       clonedView.Drawable = bm;
       clonedView.Update();
       return bm.GetImage("png");
   }

The Printer.GetBitmap method provides a simple way to create a high resolution similar to the example above.

Platforms

Windows, Linux, Android

Drawable::pixelSize Property

Gets or sets a drawable-specific pixel size.

Syntax

C++

public:
double pixelSize ( ) const;
void pixelSize ( double value )

Property Value

Type: double
Default: 0.0
The size of a drawable pixel in meters.

Remarks

This property specifies the size of a pixel, in meters. It is similar to the static screenPixelSize property, but makes it possible to override the pixel size for an individual drawable. If not specified, or set to 0.0, the value of screenPixelSize will be used.

The pixel size is used to calculate the map scale, given the view area and the size of the drawable. If you're only displaying a map in a windows on the screen, you don't need to set this property. But if you want to create a high definition image, perhaps for display on an Android device with a much higher DPI, or for sending to a printer, you can use this property together with pixelSizeAdjustments. The following C# example generates a 300 DPI image, while keeping the size of text and symbols the same as on the screen:

Generating a high-resolution map image

// Generate a 300 DPI map image
   System.IO.Stream GenerateHiResImage(Carmenta.Engine.View v)
   {
       // Create a new bitmap drawable, about 10 centimeters
       double metersPerPixel = 0.0254 / 300;
       BitmapDrawable bm = new BitmapDrawable((int)(0.1 / metersPerPixel), (int)(0.1 / metersPerPixel), Renderer.Software);

       // Set the pixel size, to make scale calculations work as if the image is 10 centimeters.
       bm.PixelSize = metersPerPixel;

       // Set rendering scale factors to make texts and symbols the same size as on the screen.
       double scaleFactor = Drawable.ScreenPixelSize / metersPerPixel;
       PixelSizeAdjustments psa = new PixelSizeAdjustments();
       psa.PolygonScaleFactor = scaleFactor;
       psa.ResolutionScaleFactor = 1.0; // Resolution will be adjusted by the PixelSize property above
       psa.SymbolScaleFactor = scaleFactor;
       psa.TextScaleFactor = scaleFactor;
       bm.PixelSizeAdjustments = psa;

       // Create the image
       Carmenta.Engine.View clonedView = v.Clone() as Carmenta.Engine.View;
       clonedView.Drawable = bm;
       clonedView.Update();
       return bm.GetImage("png");
   }

The Printer::getBitmap method provides a simple way to create a high resolution similar to the example above.

Platforms

Windows, Linux, Android

Drawable.pixelSize Property

Gets or sets a drawable-specific pixel size.

Syntax

Java

public final double getPixelSize ( );
public final void setPixelSize ( double value );

Property Value

Type: double
Default: 0.0
The size of a drawable pixel in meters.

Remarks

The pixel size is used to calculate the map scale, given the view area and the size of the drawable. If you're only displaying a map in a windows on the screen, you don't need to set this property. But if you want to create a high definition image, perhaps for display on an Android device with a much higher DPI, or for sending to a printer, you can use this property together with pixelSizeAdjustments. The following C# example generates a 300 DPI image, while keeping the size of text and symbols the same as on the screen:

Generating a high-resolution map image

// Generate a 300 DPI map image
   System.IO.Stream GenerateHiResImage(Carmenta.Engine.View v)
   {
       // Create a new bitmap drawable, about 10 centimeters
       double metersPerPixel = 0.0254 / 300;
       BitmapDrawable bm = new BitmapDrawable((int)(0.1 / metersPerPixel), (int)(0.1 / metersPerPixel), Renderer.Software);

       // Set the pixel size, to make scale calculations work as if the image is 10 centimeters.
       bm.PixelSize = metersPerPixel;

       // Set rendering scale factors to make texts and symbols the same size as on the screen.
       double scaleFactor = Drawable.ScreenPixelSize / metersPerPixel;
       PixelSizeAdjustments psa = new PixelSizeAdjustments();
       psa.PolygonScaleFactor = scaleFactor;
       psa.ResolutionScaleFactor = 1.0; // Resolution will be adjusted by the PixelSize property above
       psa.SymbolScaleFactor = scaleFactor;
       psa.TextScaleFactor = scaleFactor;
       bm.PixelSizeAdjustments = psa;

       // Create the image
       Carmenta.Engine.View clonedView = v.Clone() as Carmenta.Engine.View;
       clonedView.Drawable = bm;
       clonedView.Update();
       return bm.GetImage("png");
   }

The Printer.getBitmap method provides a simple way to create a high resolution similar to the example above.

Platforms

Windows, Linux, Android

Drawable.pixelSize Property

Gets or sets a drawable-specific pixel size.

Syntax

Python

pixelSize

Property Value

Type: double
Default: 0.0
The size of a drawable pixel in meters.

Remarks

The pixel size is used to calculate the map scale, given the view area and the size of the drawable. If you're only displaying a map in a windows on the screen, you don't need to set this property. But if you want to create a high definition image, perhaps for display on an Android device with a much higher DPI, or for sending to a printer, you can use this property together with pixelSizeAdjustments. The following C# example generates a 300 DPI image, while keeping the size of text and symbols the same as on the screen:

Generating a high-resolution map image

// Generate a 300 DPI map image
   System.IO.Stream GenerateHiResImage(Carmenta.Engine.View v)
   {
       // Create a new bitmap drawable, about 10 centimeters
       double metersPerPixel = 0.0254 / 300;
       BitmapDrawable bm = new BitmapDrawable((int)(0.1 / metersPerPixel), (int)(0.1 / metersPerPixel), Renderer.Software);

       // Set the pixel size, to make scale calculations work as if the image is 10 centimeters.
       bm.PixelSize = metersPerPixel;

       // Set rendering scale factors to make texts and symbols the same size as on the screen.
       double scaleFactor = Drawable.ScreenPixelSize / metersPerPixel;
       PixelSizeAdjustments psa = new PixelSizeAdjustments();
       psa.PolygonScaleFactor = scaleFactor;
       psa.ResolutionScaleFactor = 1.0; // Resolution will be adjusted by the PixelSize property above
       psa.SymbolScaleFactor = scaleFactor;
       psa.TextScaleFactor = scaleFactor;
       bm.PixelSizeAdjustments = psa;

       // Create the image
       Carmenta.Engine.View clonedView = v.Clone() as Carmenta.Engine.View;
       clonedView.Drawable = bm;
       clonedView.Update();
       return bm.GetImage("png");
   }

The Printer.getBitmap method provides a simple way to create a high resolution similar to the example above.

Platforms

Windows, Linux, Android

Drawable.PixelSize Property

In this article

Syntax

Property Value

Remarks

Platforms

See Also

Reference

Drawable::pixelSize Property

In this article

Syntax

Property Value

Remarks

Platforms

See Also

Reference

Drawable.pixelSize Property

In this article

Syntax

Property Value

Remarks

Platforms

See Also

Reference

Drawable.pixelSize Property

In this article

Syntax

Property Value

Remarks

Platforms

See Also

Reference