gis_data_raw_get_raster_block_count()

Получение количества блоков растровых данных в текущей карте разделяемой области памяти

Прототип:

#include <gis/gis_raw.h>
int gis_data_raw_get_raster_block_count( const gis_data_raw_context_t raw_ctx, size_t *block_number );

Аргументы:

ctx

Контекст gis_data_raw_context_t.

block_number

Указатель на переменную, в которую запишется количество блоков растровой карты.

Библиотека:

gishelper

Описание:

Функция возвращает количество блоков в текущей выбранной растровой карте в разделяемой области памяти.

Возвращаемое значение:

EOK

Успешное завершение.

EINVAL

Некорректный аргумент.

EBADFD

Некорректный указатель на разделяемую область памяти.

ENODATA

Отсутствуют карты в разделяемой области памяти.

ENOMEM

Не удалось выделить память под растровый контекст.

EFAULT

Ошибка работы с растровой картой.

Примеры использования:

gis_core_connection_t          connection;
gis_core_request_parameters_t  map;
gis_data_raw_context_t         raw_ctx;
gis_core_link_init( &connection );
gis_core_link_connect( &connection, 777 );
gis_core_databuffer_attach( &connection );
gis_core_request_parameters_init( &map );
gis_core_databuffer_data_request( &connection, &map, 1 );
gis_data_raw_ctx_alloc( &raw_ctx );
gis_data_raw_ctx_import_databuffer( raw_ctx );
gis_data_raw_select_first_map( raw_ctx );
do {
    if ( GIS_IS_CORE_MAP_DATA_SOURCE_VECTOR( gis_data_raw_map_get_data_source( raw_ctx ) ) )
        continue;
    size_t block_number = 0;
    if ( gis_data_raw_get_raster_block_count( raw_ctx, &block_number ) != EOK ) 
    {
            gis_data_raw_ctx_free( &raw_ctx );
        gis_core_databuffer_detach();
        gis_core_link_destroy( &connection, true );
            return 1;
    }
    
     if ( block_number != 15 )
     {
          printf( "Incorrect number of blocks.\n" );
          gis_data_raw_ctx_free( &raw_ctx );
        gis_core_databuffer_detach();
            gis_core_link_destroy( &connection, true );
          return 1;
     }
} while ( gis_data_raw_select_next_map( raw_ctx ) == EOK);
gis_data_raw_ctx_free( &raw_ctx );
gis_core_databuffer_detach();
gis_core_link_destroy( &connection, true );

Классификация:

ПК ЦКИ для ЗОСРВ «Нейтрино»

Безопасность использования

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

Тематические ссылки:

gis_data_raw_context_t, gis_data_raw_get_raster_width_in_blocks(), gis_data_raw_get_raster_height_in_blocks(), gis_data_raw_get_raster_width_in_elements(), gis_data_raw_get_raster_height_in_elements().

Предыдущий раздел: Описание API картографического фреймворка