1a62fdc82a
This commit implements a node to import CSV files as a point cloud. The interface is minimal, with just a file path input. The type of each column is chosen by whether the first value is an integer or a float (those are currently the only supported types). The goal of the node is to make it easier to get arbitrary data into geometry nodes for visualization purposes, for example. https://devtalk.blender.org/t/gsoc-2024-geometry-nodes-file-import-nodes/34482 Pull Request: https://projects.blender.org/blender/blender/pulls/126308
121 lines
4.0 KiB
C++
121 lines
4.0 KiB
C++
/* SPDX-FileCopyrightText: 2024 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
#include "BLI_string_ref.hh"
|
|
|
|
/*
|
|
* Various text parsing utilities used by importers.
|
|
*
|
|
* Many of these functions take two pointers (p, end) indicating
|
|
* which part of a string to operate on, and return a possibly
|
|
* changed new start of the string. They could be taking a StringRef
|
|
* as input and returning a new StringRef, but this is a hot path
|
|
* in CSV and OBJ parsing, and the StringRef approach does lose performance
|
|
* (mostly due to return of StringRef being two register-size values
|
|
* instead of just one pointer).
|
|
*/
|
|
|
|
namespace blender::io {
|
|
|
|
/**
|
|
* Fetches next line from an input string buffer.
|
|
*
|
|
* The returned line will not have '\n' characters at the end;
|
|
* the `buffer` is modified to contain remaining text without
|
|
* the input line.
|
|
*/
|
|
StringRef read_next_line(StringRef &buffer);
|
|
|
|
/**
|
|
* Fix up OBJ line continuations by replacing backslash (\) and the
|
|
* following newline with spaces.
|
|
*/
|
|
void fixup_line_continuations(char *p, char *end);
|
|
|
|
/**
|
|
* Drop leading white-space from a string part.
|
|
*/
|
|
const char *drop_whitespace(const char *p, const char *end);
|
|
|
|
/**
|
|
* Drop leading non-white-space from a string part.
|
|
*/
|
|
const char *drop_non_whitespace(const char *p, const char *end);
|
|
|
|
/**
|
|
* Parse an integer from an input string.
|
|
* The parsed result is stored in `dst`. The function skips
|
|
* leading white-space unless `skip_space=false`. If the
|
|
* number can't be parsed (invalid syntax, out of range),
|
|
* `success` value is false.
|
|
*
|
|
* Returns the start of remainder of the input string after parsing.
|
|
*/
|
|
const char *try_parse_int(
|
|
const char *p, const char *end, int fallback, bool &success, int &dst, bool skip_space = true);
|
|
|
|
/**
|
|
* Parse a float from an input string.
|
|
* The parsed result is stored in `dst`. The function skips
|
|
* leading white-space unless `skip_space=false`. If the
|
|
* number can't be parsed (invalid syntax, out of range),
|
|
* `success` value is false.
|
|
*
|
|
* Returns the start of remainder of the input string after parsing.
|
|
*/
|
|
const char *try_parse_float(const char *p,
|
|
const char *end,
|
|
int fallback,
|
|
bool &success,
|
|
float &dst,
|
|
bool skip_space = true);
|
|
|
|
/**
|
|
* Parse an integer from an input string.
|
|
* The parsed result is stored in `dst`. The function skips
|
|
* leading white-space unless `skip_space=false`. If the
|
|
* number can't be parsed (invalid syntax, out of range),
|
|
* `fallback` value is stored instead.
|
|
*
|
|
* Returns the start of remainder of the input string after parsing.
|
|
*/
|
|
const char *parse_int(
|
|
const char *p, const char *end, int fallback, int &dst, bool skip_space = true);
|
|
|
|
/**
|
|
* Parse a float from an input string.
|
|
* The parsed result is stored in `dst`. The function skips
|
|
* leading white-space unless `skip_space=false`. If the
|
|
* number can't be parsed (invalid syntax, out of range),
|
|
* `fallback` value is stored instead. If `require_trailing_space`
|
|
* is true, the character after the number has to be whitespace.
|
|
*
|
|
* Returns the start of remainder of the input string after parsing.
|
|
*/
|
|
const char *parse_float(const char *p,
|
|
const char *end,
|
|
float fallback,
|
|
float &dst,
|
|
bool skip_space = true,
|
|
bool require_trailing_space = false);
|
|
|
|
/**
|
|
* Parse a number of white-space separated floats from an input string.
|
|
* The parsed `count` numbers are stored in `dst`. If a
|
|
* number can't be parsed (invalid syntax, out of range),
|
|
* `fallback` value is stored instead.
|
|
*
|
|
* Returns the start of remainder of the input string after parsing.
|
|
*/
|
|
const char *parse_floats(const char *p,
|
|
const char *end,
|
|
float fallback,
|
|
float *dst,
|
|
int count,
|
|
bool require_trailing_space = false);
|
|
|
|
} // namespace blender::io
|