Some how Texture Loading Error by Path.

[jomin398]

three-mmd/packages/three-mmd/src/utils/build-material/index.ts

Line 177 in 2332c1f

const manager: LoadingManager = DefaultLoadingManager

Summary

I fixed a texture loading error by refactoring buildMaterials into a plugin-style hook
and injecting a custom LoadingManager.

The issue was caused by a single line that indirectly produced an invalid blob URL.

Environment

• THREE (jsdelivr cdn, esm, latest)
• MMDLoader (jsdelivr cdn, esm, latest)

What I changed

I copied the original buildMaterials implementation and modified only the manager
injection part to make it work as a plugin.

// custom manager
const cm = new THREE.DefaultLoadingManager();

// Plugin for allow the custom Manager.
const p = (_deps) => {
  return {
    buildMaterials: (pmx, geometry, resourcePath, onProgress, onError) => {
      return buildMaterial(pmx, geometry, resourcePath, onProgress, onError, cm);
    }
  };
};

function buildMaterial(data, geometry, resourcePath, onProgress, onError, customManager) {
  const crossOrigin = "anonymous";
  const manager = customManager || DefaultLoadingManager;
  // rest of code...
}

Error

Fetch API cannot load "blob:./tex/hair_Mikuv4x.tga"
URL scheme "blob" is not supported.

Root cause

This was caused by one line inside buildMaterial / loadTexture that generated an
invalid blob: relative URL when DefaultLoadingManager was not used.

After routing everything through my custom manager, the problem disappeared.

Notes

I did NOT change any logic besides the manager-related part.
All other code is identical to the original buildMaterials.

[kwaa]

Hello! Thank you for your bug report. Would you be interested in submitting a PR to this repository to fix this issue?

[jomin398]

For reference, I previously documented the texture loading flow
(from buildMaterials to loadTexture and shader application) using a Mermaid diagram.
The blob URL issue occurs in the loadTexture path-building stage
when DefaultLoadingManager is not used.

(Bwy, Sorry for korean, this is my major language)

graph TD
    Start([PMX 데이터 로드 시작]) --> BuildMat[buildMaterialWithCustomManager 시작]
    
    BuildMat --> InitLoader[텍스처 로더 초기화]
    InitLoader --> InitCache[캐시 객체 생성]
    
    InitCache --> LoopStart{각 머티리얼 순회}
    
    LoopStart --> CreateParams[파라미터 생성]
    CreateParams --> SetBasic[기본 속성 설정]
    
    SetBasic --> CheckDiffuse{디퓨즈 텍스처<br/>존재?}
    
    CheckDiffuse -->|Yes| LoadDiffuse[loadTexture 호출<br/>params.map]
    CheckDiffuse -->|No| CheckSphere
    
    LoadDiffuse --> SaveDiffusePath[파일명 저장]
    SaveDiffusePath --> CheckSphere{스피어 맵<br/>존재?}
    
    CheckSphere -->|Yes| CheckSphereMode{스피어 모드<br/>확인}
    CheckSphere -->|No| CheckToon
    
    CheckSphereMode -->|Multiply/Add| LoadSphere[loadTexture 호출<br/>params.matcap]
    LoadSphere --> SetMatcapMode[matcapCombine 설정]
    SetMatcapMode --> SaveSpherePath[파일명 저장]
    
    SaveSpherePath --> CheckToon[툰 텍스처 처리]
    
    CheckToon --> IsToonShared{공유 툰<br/>텍스처?}
    
    IsToonShared -->|Yes| UseDefaultToon[기본 툰 파일명 생성]
    IsToonShared -->|No| UseCustomToon[커스텀 툰 파일명 사용]
    
    UseDefaultToon --> LoadToon[loadTexture 호출<br/>params.gradientMap]
    UseCustomToon --> LoadToon
    
    LoadToon --> CreateMaterial[MMDToonMaterial 생성]
    CreateMaterial --> AddToArray[배열에 추가]
    
    AddToArray --> LoopStart
    
    LoopStart -->|완료| CheckMorphs[알파 모프 검사]
    CheckMorphs --> ReturnMaterials[머티리얼 반환]
    
    subgraph LoadTextureProcess ["loadTexture 함수 상세"]
        LT_Start([텍스처 경로 수신]) --> LT_CheckCache{캐시 확인}
        
        LT_CheckCache -->|Yes| LT_ReturnCache[캐시 반환]
        LT_CheckCache -->|No| LT_IsDefault{기본 툰?}
        
        LT_IsDefault -->|Yes| LT_ValidateIndex{인덱스 유효?}
        LT_IsDefault -->|No| LT_BuildPath[경로 생성]
        
        LT_ValidateIndex -->|Yes| LT_GetShared[SharedToonTextures]
        LT_ValidateIndex -->|No| LT_UseDefault[toon00.bmp 사용]
        
        LT_GetShared --> LT_SelectLoader
        LT_UseDefault --> LT_SelectLoader
        LT_BuildPath --> LT_SelectLoader
        
        LT_SelectLoader{확장자 확인} -->|.tga| LT_TGA[TGALoader]
        LT_SelectLoader -->|기타| LT_Image[TextureLoader]
        
        LT_TGA --> LT_Load[texture.load]
        LT_Image --> LT_Load
        
        LT_Load --> LT_OnLoad{로드 성공}
        
        LT_OnLoad --> LT_IsToon{툰 텍스처?}
        
        LT_IsToon -->|Yes| LT_Rotate[이미지 회전]
        LT_IsToon -->|No| LT_SetCommon
        
        LT_Rotate --> LT_SetFilter[NearestFilter 설정]
        LT_SetFilter --> LT_NoMipmap[밉맵 비활성화]
        LT_NoMipmap --> LT_SetCommon
        
        LT_SetCommon[공통 설정 적용]
        
        LT_SetCommon --> LT_Callbacks[콜백 실행]
        LT_Callbacks --> LT_Cache[캐시 저장]
        LT_Cache --> LT_Return[텍스처 반환]
    end
    
    subgraph MaterialApplication ["MMDToonMaterial 텍스처 적용"]
        MA_Construct([생성자 호출]) --> MA_InitShader[셰이더 초기화]
        
        MA_InitShader --> MA_CloneUniforms[유니폼 복제]
        
        MA_CloneUniforms --> MA_DefineProps[속성 정의]
        
        MA_DefineProps --> MA_Getter[getter 설정]
        MA_Getter --> MA_Setter[setter 설정]
        
        MA_Setter --> MA_SetValues[setValues 호출]
        
        MA_SetValues --> MA_MapApplied{map 설정됨?}
        MA_MapApplied -->|Yes| MA_MapUniform[uniforms.map에 할당]
        
        MA_MapUniform --> MA_MatcapApplied{matcap 설정됨?}
        MA_MapApplied -->|No| MA_MatcapApplied
        
        MA_MatcapApplied -->|Yes| MA_MatcapUniform[uniforms.matcap에 할당]
        MA_MatcapUniform --> MA_GradientApplied{gradientMap 설정됨?}
        MA_MatcapApplied -->|No| MA_GradientApplied
        
        MA_GradientApplied -->|Yes| MA_GradientUniform[uniforms.gradientMap에 할당]
        
        MA_GradientUniform --> MA_ShaderReady[셰이더 준비 완료]
        MA_GradientApplied -->|No| MA_ShaderReady
        
        MA_ShaderReady --> MA_Render([GLSL 샘플링])
    end
    
    ReturnMaterials --> End([완료])
    
    style Start fill:#e1f5ff
    style End fill:#e1f5ff
    style LoadTextureProcess fill:#fff4e1
    style MaterialApplication fill:#f0e1ff
    style LoadDiffuse fill:#b3e5fc
    style LoadSphere fill:#b3e5fc
    style LoadToon fill:#b3e5fc
    style LT_Load fill:#b3e5fc
    style MA_MapUniform fill:#c8e6c9
    style MA_MatcapUniform fill:#c8e6c9
    style MA_GradientUniform fill:#c8e6c9

Loading

[kwaa]

I've submitted a fix. Could you test it when you have time to see if there are any bugs? #31