This patch contains the work that I did during my week at the Code Quest - adding support for tiled images to Blender. With this patch, images now contain a list of tiles. By default, this just contains one tile, but if the source type is set to Tiled, the user can add additional tiles. When acquiring an ImBuf, the tile to be loaded is specified in the ImageUser. Therefore, code that is not yet aware of tiles will just access the default tile as usual. The filenames of the additional tiles are derived from the original filename according to the UDIM naming scheme - the filename contains an index that is calculated as (1001 + 10*<y coordinate of the tile> + <x coordinate of the tile>), where the x coordinate never goes above 9. Internally, the various tiles are stored in a cache just like sequences. When acquired for the first time, the code will try to load the corresponding file from disk. Alternatively, a new operator can be used to initialize the tile similar to the New Image operator. The following features are supported so far: - Automatic detection and loading of all tiles when opening the first tile (1001) - Saving all tiles - Adding and removing tiles - Filling tiles with generated images - Drawing all tiles in the Image Editor - Viewing a tiled grid even if no image is selected - Rendering tiled images in Eevee - Rendering tiled images in Cycles (in SVM mode) - Automatically skipping loading of unused tiles in Cycles - 2D texture painting (also across tiles) - 3D texture painting (also across tiles, only limitation: individual faces can not cross tile borders) - Assigning custom labels to individual tiles (drawn in the Image Editor instead of the ID) - Different resolutions between tiles There still are some missing features that will be added later (see T72390): - Workbench engine support - Packing/Unpacking support - Baking support - Cycles OSL support - many other Blender features that rely on images Thanks to Brecht for the review and to all who tested the intermediate versions! Differential Revision: https://developer.blender.org/D3509
100 lines
3.5 KiB
C++
100 lines
3.5 KiB
C++
/*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
/** \file
|
|
* \ingroup editors
|
|
*/
|
|
|
|
#ifndef __ED_PAINT_H__
|
|
#define __ED_PAINT_H__
|
|
|
|
struct ImBuf;
|
|
struct Image;
|
|
struct UndoStep;
|
|
struct UndoType;
|
|
struct bContext;
|
|
struct wmKeyConfig;
|
|
struct wmOperator;
|
|
|
|
/* paint_ops.c */
|
|
void ED_operatortypes_paint(void);
|
|
void ED_operatormacros_paint(void);
|
|
void ED_keymap_paint(struct wmKeyConfig *keyconf);
|
|
|
|
/* paint_image.c */
|
|
void ED_imapaint_clear_partial_redraw(void);
|
|
void ED_imapaint_dirty_region(struct Image *ima,
|
|
struct ImBuf *ibuf,
|
|
int tile_number,
|
|
int x,
|
|
int y,
|
|
int w,
|
|
int h,
|
|
bool find_old);
|
|
void ED_imapaint_bucket_fill(struct bContext *C,
|
|
float color[3],
|
|
struct wmOperator *op,
|
|
const int mouse[2]);
|
|
|
|
/* image_undo.c */
|
|
void ED_image_undo_push_begin(const char *name, int paint_mode);
|
|
void ED_image_undo_push_begin_with_image(const char *name,
|
|
struct Image *image,
|
|
struct ImBuf *ibuf,
|
|
int tile_number);
|
|
|
|
void ED_image_undo_push_end(void);
|
|
void ED_image_undo_restore(struct UndoStep *us);
|
|
|
|
void ED_image_undosys_type(struct UndoType *ut);
|
|
|
|
void *ED_image_paint_tile_find(struct ListBase *undo_tiles,
|
|
struct Image *ima,
|
|
struct ImBuf *ibuf,
|
|
int tile_number,
|
|
int x_tile,
|
|
int y_tile,
|
|
unsigned short **r_mask,
|
|
bool validate);
|
|
void *ED_image_paint_tile_push(struct ListBase *undo_tiles,
|
|
struct Image *ima,
|
|
struct ImBuf *ibuf,
|
|
struct ImBuf **tmpibuf,
|
|
int tile_number,
|
|
int x_tile,
|
|
int y_tile,
|
|
unsigned short **r_mask,
|
|
bool **r_valid,
|
|
bool use_thread_lock,
|
|
bool find_prev);
|
|
void ED_image_paint_tile_lock_init(void);
|
|
void ED_image_paint_tile_lock_end(void);
|
|
|
|
struct ListBase *ED_image_paint_tile_list_get(void);
|
|
|
|
#define ED_IMAGE_UNDO_TILE_BITS 6
|
|
#define ED_IMAGE_UNDO_TILE_SIZE (1 << ED_IMAGE_UNDO_TILE_BITS)
|
|
#define ED_IMAGE_UNDO_TILE_NUMBER(size) \
|
|
(((size) + ED_IMAGE_UNDO_TILE_SIZE - 1) >> ED_IMAGE_UNDO_TILE_BITS)
|
|
|
|
/* paint_curve_undo.c */
|
|
void ED_paintcurve_undo_push_begin(const char *name);
|
|
void ED_paintcurve_undo_push_end(void);
|
|
|
|
void ED_paintcurve_undosys_type(struct UndoType *ut);
|
|
|
|
#endif /* __ED_PAINT_H__ */
|