configureMatcapLayer

Implementation Reference

• src/tools/advanced-material-tools.js:451-481 (handler)

  The handler function that configures a matcap layer by sending a PUT request to update the layer parameters with the provided matcap image URL and optional intensity.

  async ({ sceneId, materialId, layerId, matcapImageUrl, intensity }) => {
    try {
      const layerParams = {
        matcapImageUrl,
        ...(intensity !== undefined && { intensity }),
      };
      
      await apiClient.request('PUT', `/scenes/${sceneId}/materials/${materialId}/layers/${layerId}`, {
        params: layerParams
      });
      
      return {
        content: [
          { 
            type: 'text', 
            text: `Matcap layer ${layerId} configured successfully` 
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          { 
            type: 'text', 
            text: `Error configuring matcap layer: ${error.message}` 
          }
        ],
        isError: true
      };
    }
  }

• src/tools/advanced-material-tools.js:444-450 (schema)

  Zod input schema for the configureMatcapLayer tool, validating sceneId, materialId, layerId, matcapImageUrl (required URL), and optional intensity.

  {
    sceneId: z.string().min(1).describe('Scene ID'),
    materialId: z.string().min(1).describe('Material ID'),
    layerId: z.string().min(1).describe('Layer ID'),
    matcapImageUrl: z.string().url().describe('URL to matcap image'),
    intensity: z.number().min(0).optional().default(1).describe('Matcap intensity'),
  },

• src/tools/advanced-material-tools.js:442-482 (registration)

  Registration of the 'configureMatcapLayer' tool using server.tool(), including schema and handler, within the registerAdvancedMaterialTools function.

  server.tool(
    'configureMatcapLayer',
    {
      sceneId: z.string().min(1).describe('Scene ID'),
      materialId: z.string().min(1).describe('Material ID'),
      layerId: z.string().min(1).describe('Layer ID'),
      matcapImageUrl: z.string().url().describe('URL to matcap image'),
      intensity: z.number().min(0).optional().default(1).describe('Matcap intensity'),
    },
    async ({ sceneId, materialId, layerId, matcapImageUrl, intensity }) => {
      try {
        const layerParams = {
          matcapImageUrl,
          ...(intensity !== undefined && { intensity }),
        };
        
        await apiClient.request('PUT', `/scenes/${sceneId}/materials/${materialId}/layers/${layerId}`, {
          params: layerParams
        });
        
        return {
          content: [
            { 
              type: 'text', 
              text: `Matcap layer ${layerId} configured successfully` 
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            { 
              type: 'text', 
              text: `Error configuring matcap layer: ${error.message}` 
            }
          ],
          isError: true
        };
      }
    }
  );