PrintToRaster method (MapDoc)

Записывает изображение карты в растровый файл с параметрами, заданными объектом PrintToRasterParams.

Применяется к:

MapDoc

Синтаксис:

Visual Basic:

Function PrintToRaster(Filename As String, iParams As PrintToRasterParams) As Long

Filename - полное имя растрового файла.

iParams - параметры растра: область карты, масштаб, разрешение и формат.

Описание:

В файл выводится область карты, заданная методом SetBounds или SetBoundsRectangle объекта параметров; без области файл не создается. Размер растра в точках по каждой стороне равен D / M / 0,0254 × R, где D - размер области на местности в метрах, M - знаменатель масштаба (SetScale), R - разрешение в точках на дюйм (SetResolution). По умолчанию масштаб 1:2000 и разрешение 96 точек на дюйм.

Формат файла задает метод SetRasterType: 0 - BMP, 1 - JPG, 4 - PNG, 5 - TIFF; по умолчанию - PNG, прочие значения дают BMP. Расширение в имени файла на формат не влияет.

Метод возвращает 0 и тогда, когда файл не создан (не задана область, нет папки), поэтому результат проверяйте по наличию файла. Метод работает и у карты без окна - объекта ZuluLib.MapDoc.

Пример:

Пример записывает всю карту в файл PNG в масштабе 1:2000 с разрешением 96 точек на дюйм и сообщает, создан ли файл.

Visual Basic:

Sub MapDoc_PrintToRaster
'Берем рабочую карту
Set Doc = Zulu.ActiveMapDoc
F = "C:\Data\Map.png"
Set Fso = CreateObject("Scripting.FileSystemObject")
If Fso.FileExists(F) Then Fso.DeleteFile F
'Параметры растра: вся карта, масштаб 1:2000, 96 точек на дюйм, PNG
Set P = CreateObject("ZuluLib.PrintToRasterParams")
P.SetBoundsRectangle Doc.GetBoundsRectangle
P.SetScale 2000
P.SetResolution 96
P.SetRasterType 4
Doc.PrintToRaster F, P
'Возвращаемое значение успеха не показывает - проверяем файл
If Fso.FileExists(F) Then
  MsgBox "Карта записана в файл " & F
Else
  MsgBox "Файл не создан: " & F
End If
End Sub

Python:

import zulu, os

def Macro_MapDoc_PrintToRaster():
    # Берем рабочую карту
    doc = zulu.App.ActiveMapDoc
    F = r"C:\Data\Map.png"
    if os.path.exists(F):
        os.remove(F)
    # Параметры растра: вся карта, масштаб 1:2000, 96 точек на дюйм, PNG
    P = zulu.PrintToRasterParams()
    P.SetBoundsRectangle(doc.GetBoundsRectangle())
    P.SetScale(2000)
    P.SetResolution(96)
    P.SetRasterType(4)
    doc.PrintToRaster(F, P)
    # Возвращаемое значение успеха не показывает - проверяем файл
    if os.path.exists(F):
        print("Карта записана в файл", F)
    else:
        print("Файл не создан:", F)