KA.Barcode for .NET Suite
Guide for Resizing PLANET Barcodes in C#.NET
Complete C#.NET source code to generate, print PLANET images using Barcode Generator for .NET Control

  • Create high quality PLANET Png, Gif, Jpeg, Tiff, or Bmp files in .NET projects using C#

  • Provide properties X and Y to set the width and height of the module bar

  • Print tall bar and short bar with adjustable height

  • Support the width and height setting of the whole PLANET image

  • Provide cm, inch, and pixel as the unit of measure

  • Capable of printing PLANET with minimum X

  • Also be capable of drawing maximum X in a fixed PLANET image width

PlANET, is also named as USPS PLANET Barcode, USPS Confirms Service Barcode.

In addition to PLANET size setting, this barcode control (KA.Barcode Generator for C#.NET) is able to:

PLANET C#.NET Generator Related Product Software

VB.NET PLANET Generator

Java PLANET Generator

.NET PLANET Winforms Generator

ASP.NET PLANET Generator


PLANET Size Setting Introduction

Width Setting

The width of PLANET barcode image is influenced by the parameters in the following table.

Parameter Parameter Description Range Related Property
Image Width(W) The width of the PLANET image - BarCodeWidth
Module Bar Width (X) The width of the module bar in PLANET X ≥ 1 pixel X
Left Quiet Zone Width (Q1) The space between the left edge of the image and the leftmost bar; Q1= 10 X + Left Margin Width Q1 ≥ 10X LeftMargin
Right Quiet Zone Width (Q2) The space between the right edge of the image and the rightmost bar; Q2= 10 X + Right Margin Width Q2 ≥ 10X RightMargin


Supplement note: the quantity of data characters also has an influence over the width of the barcode. See C# PLANET Size Setting - Image Width Setting.

Height Setting

The height of PLANET barcode image is made up by Top Margin width, Bottom Margin width, Bar Height, space between barcode and text, and the height of Text.

Parameter Parameter Description Range Related Property
Image Height (H) The height of the image H ≥ 5mm or 15%W H
Bar Height (Y) The height of the bar - Y
Short Bar (SY) The height of the short bars in PLANET; 0 < S < 1 ShortTallRatio
Top Margin Width The height of the top margin ≥ 0 TopMargin
Bottom Margin Width The height of the bottom margin ≥ 0 BottomMargin
Text Height The height of the human readable text font - Text Font
Text Margin The space between symbol and text ≥ 0 TextMargin


In the following section, you will see how to make changes to these parameters in .NET projects using C#.NET.


How to Use C#.NET PLANET Generator Size Setting Properties

C#.NET PLANET Generator provides C#.NET developers with a full set of properties for PLANET size setting.

Before starting size setting, please install C#.NET PLANET Generator and add the following code as namespace reference.

using KeepAutomation.Barcode.Bean;

using KeepAutomation.Barcode;

using System.Drawing.Imaging;

Input the following C# Code to use C#.NET PLANET Generator where PLANET bar code image is needed.

BarCode planet = new BarCode();

planet.Symbology = Symbology.Planet;

Input a string value for CodeToEncode, which will be encoded as data in your PLANET. Pay attention to the data encoding instruction for PLANET.

planet.CodeToEncode = "12345678901";

BarcodeUnit

Property BarcodeUnit is in control of unit of measure. Before setting the bar width and image size, you should know for sure all the properties in the coming passages are based on the unit of measure. BarcodeUnit defaults as Pixel, and you can change it to cm or inch.

planet.BarcodeUnit = BarcodeUnit.Pixel;

X

Property X (Float; Default: 1) is used in PLANET module bar width setting. Try to set X using C# code as follows:

planet.X = 2;

Now, the width of a bar in PLANET has been changed from 1 pixel (as default) to 2 pixel. You can make it even greater if wider bars are in need.

Y

Property Y (Float; Default: 50) sets the bar height of the tall bars in PLANET.

planet.Y = 40;

The width of bars in PLANET has been changed from 50 pixels (as default) to 40 pixels. You can make it even greater or smaller.

ShortTallRatio

Property ShortTallRatio (Float; Default: 0.4) sets the bar height of the short bars in PLANET.

planet.Y = 40;

code39.ShortTallRatio= 0.6;

The height of the short bars in PLANET is 24 pixels. You can make it even greater or smaller by change Y or ShortTallRatio.

BarCodeHeight and BarCodeWidth

C#.NET PLANET Generator is also equipped with functional properties BarCodeHeight (Float; Default: 0) and BarCodeWidth (Float; Default: 0) to set the size of the whole PLANET bar code image.

planet.BarCodeHeight = 70;

planet.BarCodeWidth = 175;

Note: If the setting of image size conflict with the settings in bar width or bar height, you can enable AutoResize to make the generated PLANET compatible with PLANET barcode specification.

TopMargin, BottomMargin, LeftMargin, and RightMargin

PLANET C#.NET Generator will generate a quiet zone at each end of the PLANET symbol automatically. The auto-generated quiet zone is 10X width. You can increase width of quiet zone by increasing the value of properties LeftMargin (Float; Default: 0) and RightMargin (Float; Default: 0). Also, the height of the image can be increased using TopMargin (Float; Default: 0) and BottomMargin (Float; Default: 0).

planet.TopMargin = 10;

planet.BottomMargin = 10;

planet.LeftMargin = 10;

planet.RightMargin = 10;

TextMargin

Property TextMargin (Float; Default: 6 pixel) controls the width of space between PLANET bar code and the human readable text below the barcode.

planet.TextMargin = 10;