/* =============================================================================== FILE: laszip_api.h CONTENTS: A simple DLL interface to LASzip PROGRAMMERS: info@rapidlasso.de - https://rapidlasso.de COPYRIGHT: (c) 2007-2022, rapidlasso GmbH - fast tools to catch reality This is free software; you can redistribute and/or modify it under the terms of the Apache Public License 2.0 published by the Apache Software Foundation. See the COPYING file for more information. This software is distributed WITHOUT ANY WARRANTY and without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. CHANGE HISTORY: 17 October 2025 -- support for LAS 1.5 22 August 2017 -- Add version info. 4 August 2017 -- 'laszip_set_point_type_and_size()' as minimal setup for ostream writer 3 August 2017 -- new 'laszip_create_laszip_vlr()' gets VLR as C++ std::vector 29 July 2017 -- integrating minimal stream-based reading/writing into branch 20 July 2017 -- Andrew Bell adds support for stream-based reading/writing. 28 May 2017 -- support for "LAS 1.4 selective decompression" added into DLL API 25 April 2017 -- adding initial support for new "native LAS 1.4 extension" 8 January 2017 -- name change from 'laszip_dll.h' and integration Hobu's changes for Unix 7 January 2017 -- set reserved field in LASzip VLR from 0xAABB to 0x0 7 January 2017 -- make scan angle quantization in compatibility mode consistent with LIB 7 January 2017 -- compatibility mode *decompression* fix for points with waveforms 23 September 2015 -- correct update of bounding box and counters from inventory on closing 22 September 2015 -- bug fix for not overwriting description of pre-existing "extra bytes" 5 September 2015 -- "LAS 1.4 compatibility mode" now allows pre-existing "extra bytes" 3 August 2015 -- incompatible DLL change for QSI-sponsored "LAS 1.4 compatibility mode" 8 July 2015 -- adding support for NOAA-sponsored "LAS 1.4 compatibility mode" 1 April 2015 -- adding exploitation and creation of spatial indexing information 8 August 2013 -- added laszip_get_coordinates() and laszip_set_coordinates() 6 August 2013 -- added laszip_auto_offset() and laszip_check_for_integer_overflow() 31 July 2013 -- added laszip_get_point_count() for FUSION integration 29 July 2013 -- reorganized to create an easy to use LASzip DLL =============================================================================== */ #ifndef LASZIP_API_H #define LASZIP_API_H #ifdef LASZIP_API_VERSION #include "laszip_api_version.h" #endif #include "laszip_common.h" #ifdef _WIN32 # ifdef LASZIP_DYN_LINK # ifdef LASZIP_SOURCE # define LASZIP_API __declspec(dllexport) # else # define LASZIP_API __declspec(dllimport) # endif # else # define LASZIP_API # endif #else # define LASZIP_API #endif #ifdef __cplusplus extern "C" { #endif #include /*---------------------------------------------------------------------------*/ /*--------------- DLL variables to pass data to/from LASzip -----------------*/ /*---------------------------------------------------------------------------*/ typedef int laszip_BOOL; typedef char laszip_CHAR; typedef float laszip_F32; typedef double laszip_F64; typedef void* laszip_POINTER; #ifdef _WIN32 typedef unsigned char laszip_U8; typedef unsigned short laszip_U16; typedef unsigned int laszip_U32; typedef unsigned __int64 laszip_U64; typedef char laszip_I8; typedef short laszip_I16; typedef int laszip_I32; typedef __int64 laszip_I64; #else #include typedef uint8_t laszip_U8; typedef uint16_t laszip_U16; typedef uint32_t laszip_U32; typedef uint64_t laszip_U64; typedef int8_t laszip_I8; typedef int16_t laszip_I16; typedef int32_t laszip_I32; typedef int64_t laszip_I64; #endif typedef struct laszip_geokey { laszip_U16 key_id; laszip_U16 tiff_tag_location; laszip_U16 count; laszip_U16 value_offset; } laszip_geokey_struct; #define LAS_VLR_USER_ID_CHAR_LEN 17 #define LAS_VLR_DESC_CHAR_LEN 33 typedef struct laszip_vlr { laszip_U16 reserved; laszip_CHAR user_id[LAS_VLR_USER_ID_CHAR_LEN]; laszip_U16 record_id; laszip_U16 record_length_after_header; laszip_CHAR description[LAS_VLR_DESC_CHAR_LEN]; laszip_U8* data; } laszip_vlr_struct; typedef struct laszip_header { laszip_U16 file_source_ID; laszip_U16 global_encoding; laszip_U32 project_ID_GUID_data_1; laszip_U16 project_ID_GUID_data_2; laszip_U16 project_ID_GUID_data_3; laszip_CHAR project_ID_GUID_data_4[8]; laszip_U8 version_major; laszip_U8 version_minor; laszip_CHAR system_identifier[32]; laszip_CHAR generating_software[32]; laszip_U16 file_creation_day; laszip_U16 file_creation_year; laszip_U16 header_size; laszip_U32 offset_to_point_data; laszip_U32 number_of_variable_length_records; laszip_U8 point_data_format; laszip_U16 point_data_record_length; laszip_U32 number_of_point_records; laszip_U32 number_of_points_by_return[5]; laszip_F64 x_scale_factor; laszip_F64 y_scale_factor; laszip_F64 z_scale_factor; laszip_F64 x_offset; laszip_F64 y_offset; laszip_F64 z_offset; laszip_F64 max_x; laszip_F64 min_x; laszip_F64 max_y; laszip_F64 min_y; laszip_F64 max_z; laszip_F64 min_z; // LAS 1.3 and higher only laszip_U64 start_of_waveform_data_packet_record; // LAS 1.4 and higher only laszip_U64 start_of_first_extended_variable_length_record; laszip_U32 number_of_extended_variable_length_records; laszip_U64 extended_number_of_point_records; laszip_U64 extended_number_of_points_by_return[15]; // LAS 1.5 and higher only laszip_F64 max_gps_time; laszip_F64 min_gps_time; laszip_U16 time_offset; // optional laszip_U32 user_data_in_header_size; laszip_U8* user_data_in_header; // optional VLRs laszip_vlr_struct* vlrs; // optional laszip_U32 user_data_after_header_size; laszip_U8* user_data_after_header; } laszip_header_struct; typedef struct laszip_point { laszip_I32 X; laszip_I32 Y; laszip_I32 Z; laszip_U16 intensity; laszip_U8 return_number : 3; laszip_U8 number_of_returns : 3; laszip_U8 scan_direction_flag : 1; laszip_U8 edge_of_flight_line : 1; laszip_U8 classification : 5; laszip_U8 synthetic_flag : 1; laszip_U8 keypoint_flag : 1; laszip_U8 withheld_flag : 1; laszip_I8 scan_angle_rank; laszip_U8 user_data; laszip_U16 point_source_ID; // LAS 1.4 only laszip_I16 extended_scan_angle; laszip_U8 extended_point_type : 2; laszip_U8 extended_scanner_channel : 2; laszip_U8 extended_classification_flags : 4; laszip_U8 extended_classification; laszip_U8 extended_return_number : 4; laszip_U8 extended_number_of_returns : 4; // for 8 byte alignment of the GPS time laszip_U8 dummy[7]; laszip_F64 gps_time; laszip_U16 rgb[4]; laszip_U8 wave_packet[29]; laszip_I32 num_extra_bytes; laszip_U8* extra_bytes; } laszip_point_struct; typedef void(*laszip_message_handler)( enum LAS_MESSAGE_TYPE type , const char* msg , void* user_data ); /*---------------------------------------------------------------------------*/ /*------ DLL constants for selective decompression via LASzip DLL -----------*/ /*---------------------------------------------------------------------------*/ #define laszip_DECOMPRESS_SELECTIVE_ALL 0xFFFFFFFF #define laszip_DECOMPRESS_SELECTIVE_CHANNEL_RETURNS_XY 0x00000000 #define laszip_DECOMPRESS_SELECTIVE_Z 0x00000001 #define laszip_DECOMPRESS_SELECTIVE_CLASSIFICATION 0x00000002 #define laszip_DECOMPRESS_SELECTIVE_FLAGS 0x00000004 #define laszip_DECOMPRESS_SELECTIVE_INTENSITY 0x00000008 #define laszip_DECOMPRESS_SELECTIVE_SCAN_ANGLE 0x00000010 #define laszip_DECOMPRESS_SELECTIVE_USER_DATA 0x00000020 #define laszip_DECOMPRESS_SELECTIVE_POINT_SOURCE 0x00000040 #define laszip_DECOMPRESS_SELECTIVE_GPS_TIME 0x00000080 #define laszip_DECOMPRESS_SELECTIVE_RGB 0x00000100 #define laszip_DECOMPRESS_SELECTIVE_NIR 0x00000200 #define laszip_DECOMPRESS_SELECTIVE_WAVEPACKET 0x00000400 #define laszip_DECOMPRESS_SELECTIVE_BYTE0 0x00010000 #define laszip_DECOMPRESS_SELECTIVE_BYTE1 0x00020000 #define laszip_DECOMPRESS_SELECTIVE_BYTE2 0x00040000 #define laszip_DECOMPRESS_SELECTIVE_BYTE3 0x00080000 #define laszip_DECOMPRESS_SELECTIVE_BYTE4 0x00100000 #define laszip_DECOMPRESS_SELECTIVE_BYTE5 0x00200000 #define laszip_DECOMPRESS_SELECTIVE_BYTE6 0x00400000 #define laszip_DECOMPRESS_SELECTIVE_BYTE7 0x00800000 #define laszip_DECOMPRESS_SELECTIVE_EXTRA_BYTES 0xFFFF0000 /*---------------------------------------------------------------------------*/ /*---------------- DLL functions to manage the LASzip DLL -------------------*/ /*---------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_version ( laszip_U8* version_major , laszip_U8* version_minor , laszip_U16* version_revision , laszip_U32* version_build ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_create( laszip_POINTER* pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_las_message_handler( laszip_POINTER pointer , laszip_message_handler callback , void* user_data ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_unset_las_message_handler( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_las_message_log_level( laszip_POINTER pointer , enum LAS_MESSAGE_TYPE type ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_las_message_log_level( laszip_POINTER pointer , enum LAS_MESSAGE_TYPE* type ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_error( laszip_POINTER pointer , laszip_CHAR** error ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_warning ( laszip_POINTER pointer , laszip_CHAR** warning ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_clean( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_destroy( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ /*---------- DLL functions to write and read LAS and LAZ files --------------*/ /*---------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_header_pointer( laszip_POINTER pointer , laszip_header_struct** header_pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_point_pointer( laszip_POINTER pointer , laszip_point_struct** point_pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_point_count( laszip_POINTER pointer , laszip_I64* count ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_header( laszip_POINTER pointer , const laszip_header_struct* header ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_point_type_and_size( laszip_POINTER pointer , laszip_U8 point_type , laszip_U16 point_size ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_check_for_integer_overflow( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_auto_offset( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_point( laszip_POINTER pointer , const laszip_point_struct* point ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_coordinates( laszip_POINTER pointer , const laszip_F64* coordinates ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_get_coordinates( laszip_POINTER pointer , laszip_F64* coordinates ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_geokeys( laszip_POINTER pointer , laszip_U32 number , const laszip_geokey_struct* key_entries ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_geodouble_params( laszip_POINTER pointer , laszip_U32 number , const laszip_F64* geodouble_params ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_geoascii_params( laszip_POINTER pointer , laszip_U32 number , const laszip_CHAR* geoascii_params ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_add_attribute( laszip_POINTER pointer , laszip_U32 type , const laszip_CHAR* name , const laszip_CHAR* description , laszip_F64 scale , laszip_F64 offset ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_add_vlr( laszip_POINTER pointer , const laszip_CHAR* user_id , laszip_U16 record_id , laszip_U16 record_length_after_header , const laszip_CHAR* description , const laszip_U8* data ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_remove_vlr( laszip_POINTER pointer , const laszip_CHAR* user_id , laszip_U16 record_id ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_create_spatial_index( laszip_POINTER pointer , const laszip_BOOL create , const laszip_BOOL append ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_preserve_generating_software( laszip_POINTER pointer , const laszip_BOOL preserve ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_request_native_extension( laszip_POINTER pointer , const laszip_BOOL request ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_request_compatibility_mode( laszip_POINTER pointer , const laszip_BOOL request ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_set_chunk_size( laszip_POINTER pointer , const laszip_U32 chunk_size ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_open_writer( laszip_POINTER pointer , const laszip_CHAR* file_name , laszip_BOOL compress ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_write_point( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_write_indexed_point( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_update_inventory( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_close_writer( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_exploit_spatial_index( laszip_POINTER pointer , const laszip_BOOL exploit ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_decompress_selective( laszip_POINTER pointer , const laszip_U32 decompress_selective ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_open_reader( laszip_POINTER pointer , const laszip_CHAR* file_name , laszip_BOOL* is_compressed ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_has_spatial_index( laszip_POINTER pointer , laszip_BOOL* is_indexed , laszip_BOOL* is_appended ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_inside_rectangle( laszip_POINTER pointer , laszip_F64 min_x , laszip_F64 min_y , laszip_F64 max_x , laszip_F64 max_y , laszip_BOOL* is_empty ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_seek_point( laszip_POINTER pointer , laszip_I64 index ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_read_point( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_read_inside_point( laszip_POINTER pointer , laszip_BOOL* is_done ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_close_reader( laszip_POINTER pointer ); /*---------------------------------------------------------------------------*/ /*---------------- DLL functions to load and unload LASzip ------------------*/ /*---------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------*/ laszip_I32 laszip_load_dll ( ); /*---------------------------------------------------------------------------*/ laszip_I32 laszip_unload_dll ( ); #ifdef __cplusplus } // extern "C" #if defined(_MSC_VER) && (_MSC_VER < 1300) #include #else #include #include #endif /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_open_reader_stream( laszip_POINTER pointer , std::istream& stream , laszip_BOOL* is_compressed ); /*---------------------------------------------------------------------------*/ LASZIP_API laszip_I32 laszip_open_writer_stream( laszip_POINTER pointer , std::ostream& stream , laszip_BOOL compress , laszip_BOOL do_not_write_header ); /*---------------------------------------------------------------------------*/ // make LASzip VLR for point type and point size already specified earlier LASZIP_API laszip_I32 laszip_create_laszip_vlr( laszip_POINTER pointer , laszip_U8** vlr , laszip_U32* vlr_size ); #endif // __cplusplus #endif /* LASZIP_API_H */