#pragma once #include "ggml.h" #include "mtmd.h" #include #include #include // !!! Internal header, to be used by mtmd only !!! #define MTMD_INTERNAL_HEADER struct clip_ctx; struct clip_image_size { int width; int height; bool operator==(const clip_image_size & other) const { return width == other.width && height == other.height; } bool operator!=(const clip_image_size & other) const { return !(*this == other); } int area() const { return width * height; } }; struct clip_image_f32; struct clip_image_u8_batch; struct clip_image_f32_batch; enum clip_modality { CLIP_MODALITY_VISION, CLIP_MODALITY_AUDIO, }; enum clip_flash_attn_type { CLIP_FLASH_ATTN_TYPE_AUTO = -1, CLIP_FLASH_ATTN_TYPE_DISABLED = 0, CLIP_FLASH_ATTN_TYPE_ENABLED = 1, }; struct clip_context_params { bool use_gpu; enum clip_flash_attn_type flash_attn_type; int image_min_tokens; int image_max_tokens; bool warmup; ggml_backend_sched_eval_callback cb_eval; void * cb_eval_user_data; bool no_alloc; }; struct clip_init_result { struct clip_ctx * ctx_v; // vision context struct clip_ctx * ctx_a; // audio context }; struct clip_init_result clip_init(const char * fname, struct clip_context_params ctx_params); void clip_free(struct clip_ctx * ctx); int32_t clip_get_image_size (const struct clip_ctx * ctx); int32_t clip_get_patch_size (const struct clip_ctx * ctx); int32_t clip_get_hidden_size(const struct clip_ctx * ctx); // TODO: should be enum, not string const char * clip_patch_merge_type(const struct clip_ctx * ctx); int clip_n_output_tokens(const struct clip_ctx * ctx, struct clip_image_f32 * img); // for M-RoPE, this will be the number of token positions in X and Y directions // for other models, X will be the total number of tokens and Y will be 1 int clip_n_output_tokens_x(const struct clip_ctx * ctx, struct clip_image_f32 * img); int clip_n_output_tokens_y(const struct clip_ctx * ctx, struct clip_image_f32 * img); // this should be equal to the embedding dimension of the text model int clip_n_mmproj_embd(const struct clip_ctx * ctx); struct clip_image_size * clip_image_size_init(void); struct clip_image_u8 * clip_image_u8_init (void); struct clip_image_f32 * clip_image_f32_init(void); struct clip_image_f32_batch * clip_image_f32_batch_init(void); // only used by libllava void clip_image_size_free (struct clip_image_size * img_size); void clip_image_u8_free (struct clip_image_u8 * img); void clip_image_f32_free(struct clip_image_f32 * img); void clip_image_u8_batch_free (struct clip_image_u8_batch * batch); void clip_image_f32_batch_free(struct clip_image_f32_batch * batch); // use for accessing underlay data of clip_image_f32_batch size_t clip_image_f32_batch_n_images(const struct clip_image_f32_batch * batch); // equivalent to batch->size() size_t clip_image_f32_batch_nx(const struct clip_image_f32_batch * batch, int idx); // equivalent to batch[idx]->nx size_t clip_image_f32_batch_ny(const struct clip_image_f32_batch * batch, int idx); // equivalent to batch[idx]->ny struct clip_image_f32 * clip_image_f32_get_img(const struct clip_image_f32_batch * batch, int idx); // equivalent to batch[idx]->data bool clip_image_encode (struct clip_ctx * ctx, int n_threads, struct clip_image_f32 * img, float * vec); bool clip_image_batch_encode(struct clip_ctx * ctx, int n_threads, const struct clip_image_f32_batch * imgs, float * vec); bool clip_is_llava(const struct clip_ctx * ctx); // note for contributor: this clip_is_(model) pattern is deprecated // do NOT add new functions like this bool clip_has_vision_encoder(const struct clip_ctx * ctx); bool clip_has_audio_encoder(const struct clip_ctx * ctx); int clip_model_n_batch_max(const struct clip_ctx * ctx); std::map clip_get_mem_usage(const struct clip_ctx * ctx); struct clip_cap { bool has_vision; bool has_audio; }; struct clip_cap clip_get_cap(const char * fname);