liblas-release-x64(包括liblas.lib,liblas.dll,include文件)

/****************************************************************************** * $Id$ * * Project: libLAS - http://liblas.org - A BSD library for LAS format data. * Purpose: Main prototypes for the libLAS C API * Author: Howard Butler, hobu.inc@gmail.com * ****************************************************************************** * Copyright (c) 2008, Howard Butler * * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following * conditions are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided * with the distribution. * * Neither the name of the Martin Isenburg or Iowa Department * of Natural Resources nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY * OF SUCH DAMAGE. ****************************************************************************/ #ifndef LIBLAS_H_INCLUDED #define LIBLAS_H_INCLUDED #define LIBLAS_C_API 1 #include "las_version.h" #include "las_config.h" #include <liblas/export.hpp> typedef struct LASWriterHS *LASWriterH; typedef struct LASReaderHS *LASReaderH; typedef struct LASPointHS *LASPointH; typedef struct LASHeaderHS *LASHeaderH; typedef struct LASGuidHS *LASGuidH; typedef struct LASVLRHS *LASVLRH; typedef struct LASColorHS *LASColorH; typedef struct LASSRSHS *LASSRSH; typedef struct LASSchemaHS *LASSchemaH; LAS_C_START #define LAS_MODE_READ 0 #define LAS_MODE_WRITE 1 #define LAS_MODE_APPEND 2 /** * \todo to be documented */ typedef enum { LE_None = 0, LE_Debug = 1, LE_Warning = 2, LE_Failure = 3, LE_Fatal = 4 } LASError; /** Returns the version string for this library. * @return the version string for this library. */ LAS_DLL char* LAS_GetVersion(void); LAS_DLL char* LAS_GetFullVersion(void); LAS_DLL int LAS_IsLibGeoTIFFEnabled(void); LAS_DLL int LAS_IsGDALEnabled(void); LAS_DLL int LAS_IsLibSpatialIndexEnabled(void); /****************************************************************************/ /* Error handling */ /****************************************************************************/ /** Resets the error stack for the libLAS C API. */ LAS_DLL void LASError_Reset(void); /** Pops the top error off of the error stack for the libLAS C API. */ LAS_DLL void LASError_Pop(void); /** Returns the error number of the last error on the error stack. * @return the error number of the last error on the error stack. */ LAS_DLL LASError LASError_GetLastErrorNum(void); /** Returns the name of the method the last error message happened in. * @return the name of the method the last error message happened in. */ LAS_DLL char * LASError_GetLastErrorMsg(void); /** Returns the name of the method the last error message happened in. * @return the name of the method the last error message happened in. */ LAS_DLL char * LASError_GetLastErrorMethod(void); /** Returns the number of error messages on the error stack. * @return the number of error messages on the error stack. */ LAS_DLL int LASError_GetErrorCount(void); /** Prints the last error message in the error stack to stderr. If * there is no error on the error stack, only the message is printed. * The function does not alter the error stack in any way. * @param message Message to include in the stderr output */ LAS_DLL void LASError_Print(const char* message); /****************************************************************************/ /* Reader operations */ /****************************************************************************/ /** Creates a LASReaderH object that can be used to read LASHeaderH and * LASPointH objects with. The LASReaderH must not be created with a * filename that is opened for read or write by any other API functions. * @return opaque pointer to a LASReaderH instance. * @param filename Filename to open for read */ LAS_DLL LASReaderH LASReader_Create(const char * filename); /** Creates a LASReaderH object that can be used to read LASHeaderH and * LASPointH objects with. The LASReaderH must not be created with a * filename that is opened for read or write by any other API functions. * This function allows you to optionally override the file's header * information with your own. * @return opaque pointer to a LASReaderH instance. * @param filename Filename to open for read * @param hHeader a LASHeaderH instance to override the file's header with. * */ LAS_DLL LASReaderH LASReader_CreateWithHeader( const char * filename, LASHeaderH hHeader); /** Reads the next available point on the LASReaderH instance. If no point * is available to read, NULL is returned. If an error happens during * the reading of the next available point, an error will be added to the * error stack and can be returned with the LASError_GetLastError* methods. * @param hReader the opaque handle to the LASReaderH * @return an opaque handle to a LASPointH object, or NULL if no point is * available to read or an error occured. Use the * LASError_GetLastError* methods to confirm the existence of an error * if NULL is returned. */ LAS_DLL LASPointH LASReader_GetNextPoint(const LASReaderH hReader); /** Reads a LASPointH from the given position in the LAS file represented * by the LASReaderH instance. If no point is available at that location, * NULL is returned. If an error happens during the reading of the point, * an error will be added to the error stack and can be returned with the * LASError_GetLastError* methods. * @param hReader the opaque handle to the LASReaderH * @param position the integer position of the point in the file to read. * @return an opaque handle to a LASPointH object, or NULL if no point is * available at the given location or an error occured. Use the * LASError_GetLastError* methods to confirm the existence of an error * if NULL is returned. */ LAS_DLL LASPointH LASReader_GetPointAt(const LASReaderH hReader, unsigned int position); /** Closes the file for reading operations represented by the LASReaderH instance. * @param hReader the opqaue handle to the LASReaderH */ LAS_DLL void LASReader_Destroy(LASReaderH hReader); /** Returns a LASHeaderH representing the header for the file * @param hReader the LASReaderH instance * @return a LASHeaderH representing the header for the file. NULL is returned * in the event of an error. Use the LASError_GetLastError* methods to check * in the event of a NULL return. */ LAS_DLL LASHeaderH LASReader_GetHeader(const LASReaderH hReader); LAS_DLL void LASReader_SetHeader( LASReaderH h