aboutsummaryrefslogtreecommitdiff
path: root/docs/source/development/reference
AgeCommit message (Collapse)Author
2021-11-19Merge pull request #2944 from direvus/2540-docs-missing-funcsKristian Evers
DOCS: Add doxygen entry for proj_context_set_search_paths.
2021-10-05Add proj_trans_bounds to compute the image of a input bounding box through a ↵Alan D. Snow
transformation (#2882) Fixes #2779
2021-09-30proj_factors(): accept P to be a projected CRS (fixes #2854)Even Rouault
Updated doc: Starting with PROJ 8.2, the P object can be a projected CRS, for example instantiated from a EPSG CRS code. The factors computed will be those of the map projection implied by the transformation from the base geographic CRS of the projected CRS to the projected CRS. The input geodetic coordinate lp should be such that lp.lam is the longitude in radian, and lp.phi the latitude in radian (thus independently of the definition of the base CRS, if P is a projected CRS).
2021-09-14PROJJSON: support additional properties allowed in id object (version, ↵Even Rouault
authority_citation, uri) for parity with WKT2:2019
2021-08-19BoundCRS: accept importing/exporting in WKT2 and PROJJSON the ↵Even Rouault
scope/area/extent/id attributes (fixes #2813) For PROJJSON only, also accept the ``name`` attribute.
2021-05-04DOC: configure and add spelling wordlist; fix typos, apply Sphinx syntax (#2705)Mike Taves
2021-03-17Doc: add a page to document macrosEven Rouault
2021-03-12DOC: Use breathe>=4.27 to support Doxygen \page, \section, etc.Mike Taves
2021-03-10Improve docs for geodesic distance functions in proj.hKristian Evers
2021-03-07doc: typo fixesEven Rouault
2021-01-17fix a few typos in the docsMartijn Visser
2020-12-15proj_create_crs_to_crs_from_pj(): add ACCURACY and ALLOW_BALLPARK optionsEven Rouault
2020-12-15proj_trans_array(): make it transform all coordinates even when an error occursEven Rouault
2020-12-15Doc: document error codes and proj_context_errno_string()Even Rouault
2020-12-11funtions.rst: fix sphynx syntaxEven Rouault
2020-12-09Doc: fix return data type of proj_trans_array()Even Rouault
2020-12-02cs2cs / proj_create_crs_to_crs_from_pj(): add a --authority switch to ↵Even Rouault
control where coordinate operations are looked for (fixes #2442)
2020-11-20Remove proj_api.hKristian Evers
Removes proj_api.h from the public API. The contents of the header file has been moved to proj_internal.h verbatim and any references to proj_api.h has been changed to proj_internal.h. The documentation of proj_api.h has been removed. The only exception to this is the API migration guides which still mention the old API. Fixes #837
2020-10-19C API: add proj_context_clone() (#2383)Alan D. Snow
Fixes #2382
2020-09-02Doc: document members of C structures generated from DoxygenEven Rouault
2020-08-31docs: Document missing members of PJ_COORDKristian Evers
2020-07-03Doc: improve cs2cs doc by mentionning possibility to use EPSG CRS names (#2290)Even Rouault
2020-06-05Doc: use Doxygen output for proj_normalize_for_visualization() to avoid ↵Even Rouault
duplication of info (current .rst content is outdated)
2020-05-09scripts/fix_typos.sh: fix URLs to dictionaries, and fix typos spottedEven Rouault
2020-04-24Doc: fixes for Sphinx 3.0 compat [skip appveyor] (#2191)Even Rouault
Those changes are also compatible with Sphinx 2.x The use of .. cpp:enumerator:: for a C enum is questionable, but .. c:member:: no longer works in Sphinx 3 for the value of a C enum, but .. c:enumerator:: is Sphinx 3 only ( https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#directive-c-enumerator ) Sphinx 3 is also more strict with the use of cross-reference to C types. It rejects cross-references to things like `` :c:type:`int` `` since this isn't a type we actually define.
2020-04-20Moved proj_context_get_url_endpoint & ↵Alan D. Snow
proj_context_get_user_writable_directory to proj.h (#2162) Fixes #2028
2020-04-12Add proj_degree_input() and proj_degree_output()Kristian Evers
Equivalent to proj_angular_input() and proj_angular_output() but checking for degree units instead. proj_create_crs_to_crs() rarely, if ever, returns pipelines that has radians as input or output so using proj_angular_*() is not a useful check for io units of pipelines. These two new functions should make life a bit easier for users that generally store there angular coordinates in radians. Closes #2027
2020-03-12Add proj_get_units_from_database() (fixes #2004)Even Rouault
2020-03-10fix documentation for proj_trans_generic(), see ↵Colin Doig
https://github.com/OSGeo/PROJ/issues/2032 (#2037)
2020-02-24Expose proj_context_is_network_enabled() in C APIEven Rouault
2020-01-22Merge RFC4 (#1865)Even Rouault
This commit is the result of the squashing of rfc4_dev branch in a single commit. It implements mostly RFC 4 related work. * Grid handling: - remove obsolete and presumably unfinished implementation of grid catalog functionality - all grid functionality is in grids.cpp/.hpp - vertical and horizontal grid shift: rework to no longer load whole grid into memory - remove hgrids and vgrids member from PJ structure, and store them in hgridshift/vgridshift/deformation structures - build systems: add optional libtiff dependency. Must be explicitly disabled if not desired - add support for horizontal and vertical grids in GeoTIFF, if libtiff is available - add GenericShiftGridSet and GenericShiftGrid classes, relying on TIFF grids, that can be used for generic purpose grid-based adjustment - add a +proj=xyzgridshift method to perform geocentric translation by grid. Used for French NTF to RGF93 transformation using gr3df97a.tif grid - deformation: add support for +grids= for GeoTIFF grids - horizontal grid shift: fix failures on points slightly outside a subgrid (fixes #209) * File management: - add a filemanager.cpp/.hpp to deal with file related work - test for legacy proj_api.h fileapi - proj.h: add proj_context_set_fileapi() and proj_context_set_sqlite3_vfs_name() (fixes #866) - add capability to read resource files from the user writable directory * Network access: - build systems: add optional curl dependency - add a curl-based default implementation for network related functionality - proj.h: add C API to control network functionality, and optionaly provide network callbacks - add data/proj.ini with default settings - add a SQLite3 local cache of downloaded chunks - add proj_is_download_needed() and proj_download_file() * Use Win32 Unicode APIs and expect all strings to be UTF-8 (fixes #1765) For backward compatibility, if PROJ_LIB content is found to be not UTF-8 or pointing to a non existing directory, then an attempt at interpretating it in the ANSI page encoding is done. proj_context_set_search_paths() now assumes strings to be in UTF-8, and functions returning paths will also return values in UTF-8.
2019-08-26Add a proj_cleanup() function to free global resources, typically at process ↵Even Rouault
termination
2019-08-23Add proj_create_crs_to_crs_from_pj()Even Rouault
I've been frustrated a number of times with proj_create_crs_to_crs() not accepting a PJ* object for the source and target CRS. And thus constraining to go back to WKT2 in a artificial way.
2019-05-01Merge pull request #1433 from rouault/update_quickstartKristian Evers
Doc: update quickstart with PROJ 6 API + add PROJ 4->6 migration guide (fixes #1403)
2019-04-22proj_create(): add support for compoundCRS and concatenatedOperation named ↵Even Rouault
from their components Support following syntaxes: - OGC URN combining references for compoundCRS: e.g. "urn:ogc:def:crs,crs:EPSG::2393,crs:EPSG::5717" - its GDAL shortcut: e.g. "EPSG:2393+5717" - OGC URN combining references for concatenated operations: e.g. "urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618"
2019-04-19Doc: update quickstart with PROJ 6 API (fixes #1403)Even Rouault
2019-04-02Docs: Clarify that angular in proj_angular_input/output means radiansKristian Evers
2019-03-28Docs: Clarify axis ordering used in proj_trans_generic()Kristian Evers
2019-01-22proj_create_crs_to_crs(): defer selection of actual coordinate operation ↵Even Rouault
until proj_trans() is called (fixes #1229)
2019-01-19Doc: update cs2cs and also C API regarding area of use (fixes #1186)Even Rouault
2019-01-17Doc: update docs of proj_create(), proj_create_argv() and ↵Even Rouault
proj_create_crs_to_crs() (refs #1223)
2019-01-17Remove proj_create_from_proj_string() and proj_create_from_user_input(), and ↵Even Rouault
make proj_create() do more or less what proj_create_from_user_input() did before (fixes #1214)
2019-01-10Doc: document interaction issues between objects create with proj_create() ↵Even Rouault
vs the ones of the C++ API (fixes #1213) (#1215)
2019-01-01Split ISO19111 C API docs into functions and typesKristian Evers
The rest of the C API is structured such that type definitions goes into one page and functions to another. This commit makes sure the same is done for the C bindings to the ISO19111 C++ API by defining two doxygen groups in proj.h, which is then organized into the proper pages with Sphinx and breathe.
2018-11-14Implement RFC 2: Initial integration of "GDAL SRS barn" workEven Rouault
This work mostly consists of: - a C++ implementation of the ISO-19111:2018 / OGC Topic 2 "Referencing by coordinates" classes to represent Datums, Coordinate systems, CRSs (Coordinate Reference Systems) and Coordinate Operations. - methods to convert between this C++ modeling and WKT1, WKT2 and PROJ string representations of those objects - management and query of a SQLite3 database of CRS and Coordinate Operation definition - a C API binding part of those capabilities This is all-in-one squashed commit of the work of https://github.com/OSGeo/proj.4/pull/1040
2018-11-10Remove proj_geocentric_latitude from public APIKristian Evers
Closes #1107
2018-10-16Move struct definitions for proj_list_* functions to proj.hKristian Evers
With projects.h not being available to outside users anymore we need to define PJ_UNITS, PJ_ELLPS, PJ_PRIME_MERIDIANS and PJ_OPERATIONS elsewhere. Related pj_get_*_ref() functions have been removed in favour of their proj_ namespaced counterparts. char pointers have been changed to const char pointers. Resolves #983 Resolved #1147 Make char pointers const
2018-09-07Change note to versionadded directiveKristian Evers
2018-09-07Fix formatting error in API functions docsKristian Evers
2018-07-06Add info on errnos when PJ creation fails.Kristian Evers
This was left out when documented the various proj_create_* functions. Added proj_context_errno description as well since it was undocumented and is needed when creating PJs for a specific context.