ED_fileselect.hh

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2008 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */

 
#pragma once
 
#include <string>
 
#include "BLI_vector.hh"
 
#include "DNA_uuid_types.h"
 
struct ARegion;
struct FileAssetSelectParams;
struct FileDirEntry;
struct FileSelectParams;
struct FSMenu;
struct FSMenuEntry;
struct ID;
struct ScrArea;
struct SpaceFile;
struct bContext;
struct bScreen;
struct uiBlock;
struct wmOperator;
struct wmWindow;
struct wmWindowManager;
struct View2D;
struct rcti;
namespace blender::asset_system {
class AssetLibrary;
}
 
#define FILE_LAYOUT_HOR 1
#define FILE_LAYOUT_VER 2
 
enum FileAttributeColumnType {
  COLUMN_NONE = -1,
  COLUMN_NAME = 0,
  COLUMN_DATETIME,
  COLUMN_SIZE,
 
  ATTRIBUTE_COLUMN_MAX
};
 
struct FileAttributeColumn {
  const char *name;
 
  float width;
  int sort_type; /* eFileSortType */

  int text_align; /* eFontStyle_Align */
};
 
struct FileLayout {
  /* view settings - XXX: move into its own struct. */
  int offset_top;
  int attribute_column_header_h;
  int prv_w;
  int prv_h;
  int list_padding_top;
  int tile_w;
  int tile_h;
  int tile_border_x;
  int tile_border_y;
  int prv_border_x;
  int prv_border_y;
  int rows;
  int flow_columns;
  int width;
  int height;
  int flag;
  int dirty;
  int text_line_height;
  int text_lines_count;
  FileAttributeColumn attribute_columns[ATTRIBUTE_COLUMN_MAX];

  short curr_size;
};
 
struct FileSelection {
  int first;
  int last;
};

FileSelectParams *ED_fileselect_ensure_active_params(SpaceFile *sfile);
FileSelectParams *ED_fileselect_get_active_params(const SpaceFile *sfile);
FileSelectParams *ED_fileselect_get_file_params(const SpaceFile *sfile);
FileAssetSelectParams *ED_fileselect_get_asset_params(const SpaceFile *sfile);
bool ED_fileselect_is_local_asset_library(const SpaceFile *sfile);
 
void ED_fileselect_set_params_from_userdef(SpaceFile *sfile);
void ED_fileselect_params_to_userdef(SpaceFile *sfile,
                                     const int temp_win_size[2],
                                     bool is_maximized);
 
void ED_fileselect_init_layout(SpaceFile *sfile, ARegion *region);
 
FileLayout *ED_fileselect_get_layout(SpaceFile *sfile, ARegion *region);
 
int ED_fileselect_layout_numfiles(FileLayout *layout, ARegion *region);
int ED_fileselect_layout_offset(FileLayout *layout, int x, int y);
FileSelection ED_fileselect_layout_offset_rect(FileLayout *layout, const rcti *rect);

void ED_fileselect_layout_maskrect(const FileLayout *layout, const View2D *v2d, rcti *r_rect);
bool ED_fileselect_layout_is_inside_pt(const FileLayout *layout, const View2D *v2d, int x, int y);
bool ED_fileselect_layout_isect_rect(const FileLayout *layout,
                                     const View2D *v2d,
                                     const rcti *rect,
                                     rcti *r_dst);
void ED_fileselect_layout_tilepos(const FileLayout *layout, int tile, int *x, int *y);
 
void ED_operatormacros_file();
 
void ED_fileselect_clear(wmWindowManager *wm, SpaceFile *sfile);
void ED_fileselect_clear_main_assets(wmWindowManager *wm, SpaceFile *sfile);
 
void ED_fileselect_exit(wmWindowManager *wm, SpaceFile *sfile);
 
bool ED_fileselect_is_file_browser(const SpaceFile *sfile);
bool ED_fileselect_is_asset_browser(const SpaceFile *sfile);
blender::asset_system::AssetLibrary *ED_fileselect_active_asset_library_get(
    const SpaceFile *sfile);
ID *ED_fileselect_active_asset_get(const SpaceFile *sfile);
 
void ED_fileselect_activate_asset_catalog(const SpaceFile *sfile, bUUID catalog_id);

int /* #eAssetImportMethod */ ED_fileselect_asset_import_method_get(const SpaceFile *sfile,
                                                                    const FileDirEntry *file);

void ED_fileselect_activate_by_id(SpaceFile *sfile, ID *asset_id, bool deferred);
 
void ED_fileselect_deselect_all(SpaceFile *sfile);
void ED_fileselect_activate_by_relpath(SpaceFile *sfile, const char *relative_path);
 
void ED_fileselect_window_params_get(const wmWindow *win, int r_win_size[2], bool *r_is_maximized);

ScrArea *ED_fileselect_handler_area_find(const wmWindow *win, const wmOperator *file_operator);
ScrArea *ED_fileselect_handler_area_find_any_with_op(const wmWindow *win);

void ED_fileselect_ensure_default_filepath(bContext *C, wmOperator *op, const char *extension);
 
blender::Vector<std::string> ED_fileselect_selected_files_full_paths(const SpaceFile *sfile);
 
/* TODO: Maybe we should move this to BLI?
 * On the other hand, it's using defines from space-file area, so not sure... */
int ED_path_extension_type(const char *path);
int ED_file_extension_icon(const char *path);
int ED_file_icon(const FileDirEntry *file);
 
void ED_file_read_bookmarks();

void ED_file_change_dir_ex(bContext *C, ScrArea *area);
void ED_file_change_dir(bContext *C);
 
void ED_file_path_button(bScreen *screen,
                         const SpaceFile *sfile,
                         FileSelectParams *params,
                         uiBlock *block);
 
/* File menu stuff */
 
/* FSMenuEntry's without paths indicate separators */
struct FSMenuEntry {
  FSMenuEntry *next;
 
  char *path;
  char name[256]; /* FILE_MAXFILE */
  short save;
  short valid;
  int icon;
};
 
enum FSMenuCategory {
  FS_CATEGORY_SYSTEM,
  FS_CATEGORY_SYSTEM_BOOKMARKS,
  FS_CATEGORY_BOOKMARKS,
  FS_CATEGORY_RECENT,
  FS_CATEGORY_OTHER,
};
 
enum FSMenuInsert {
  FS_INSERT_SORTED = (1 << 0),
  FS_INSERT_SAVE = (1 << 1),
  FS_INSERT_FIRST = (1 << 2),
  FS_INSERT_LAST = (1 << 3),
  FS_INSERT_NO_VALIDATE = (1 << 4),
};
 
FSMenu *ED_fsmenu_get();
FSMenuEntry *ED_fsmenu_get_category(FSMenu *fsmenu, FSMenuCategory category);
void ED_fsmenu_set_category(FSMenu *fsmenu, FSMenuCategory category, FSMenuEntry *fsm_head);
 
int ED_fsmenu_get_nentries(FSMenu *fsmenu, FSMenuCategory category);
 
FSMenuEntry *ED_fsmenu_get_entry(FSMenu *fsmenu, FSMenuCategory category, int idx);
 
char *ED_fsmenu_entry_get_path(FSMenuEntry *fsentry);
void ED_fsmenu_entry_set_path(FSMenuEntry *fsentry, const char *path);
 
char *ED_fsmenu_entry_get_name(FSMenuEntry *fsentry);
void ED_fsmenu_entry_set_name(FSMenuEntry *fsentry, const char *name);
 
int ED_fsmenu_entry_get_icon(FSMenuEntry *fsentry);
void ED_fsmenu_entry_set_icon(FSMenuEntry *fsentry, int icon);